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PREFACE 


This manual describes the software of the AMPL* Microprocessor Prototyping Laboratory and 
the hardware installation of the emulator and buffer module and the logic-state trace data 
module which support the prototyping laboratory. The manual also describes the AMPL language 
in detail, and includes examples of the use of the laboratory to debug hardware and software. 

The manual is organized into seven sections and eight appendixes including: 

I General Description - Provides a general description of the prototyping laboratory and 
its hardware and software components. Also describes the prototype development 
cycle. 

II System Hardware Installation — Describes the hardware configuration of the laboratory 
in detail, including interconnection information. 

III AMPL Applications — Describes the use of the AMPL language in development of the 
hardware of a prototype system. 

IV AMPL Microprocessor Prototyping Language - Describes the AMPL language in detail. 

V System Operation — Includes operating instructions for AMPL software and description 
of the user commands. 

VI Errors and Recovery — Describes the error and warning message formats and lists the 
error messages and recovery procedures. 

VII Examples - Includes examples of the use of the AMPL language in developing the 
software of a prototype system. 

A TX900 System Generation - Describes the generation of a custom TX990 for prototyp- 
ing laboratory. 

B DX10 System Generation - Describes the generation of a custom DX10 for prototyping 
laboratory. 

C AMPL Grammar — The formal definition of the AMPL grammer. 

D AMPL Statement Summary — A summary of the AMPL statements. 

E AMPL Reserved Words — A list of the reserved words of the AMPL language. 

F System Symbols — A list of the system variables of the AMPL system. 

G User Commands — A summary of the AMPL user commands. 


*Trademark of Texas Instruments Incorporated 
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H AMPL Procedure and Function Library - Descriptions of the procedures and functions 
of the AMPL Procedure and Function Library. 

I Glossary — A glossary of terms used in tne manual. 
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The following documents contain additional information related to the prototyping laboratory: 
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990 Computer Family Systems Handbook 

945250-9701 


<ft 

Model 990 Computer TMS 9900 Microprocessor 
Assembly Language Programmer’s Guide 
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■ 

41 

Model 990 Computer TX990 Operating System 
Programmer’s Guide 

946259-9701 



Model 990 Computer Terminal Executive Development 
System (TXDS) Programmer’s Guide 
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Reference Manual Vols. 1-6 
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Model 990 Computer FS990 System 
Installation and Operation Manual 
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946284-9701 



Model 990/4 Computer System Hardware Reference 
Manual 
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Mode! 990 Computer AM PL Logic State Trace Data 
Module Depot Maintenance Manual 
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Module Installation and Operation 
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SECTION I 

GENERAL DESCRIPTION 


1.1 INTRODUCTION 

The AM PL Microprocessor Prototyping Laboratory is a powerful tool for developing microprocessor 
systems. The laboratory contributes significantly to the development of both software (or firmware) 
and a hardware prototype. A prototyping laboratory includes the following: 

• A Model 990 Computer and operating system with dual floppy disks or a moving-head disk. 

• A hardware Emulator with TMS 9900 Buffer Module or TMS 9980 Buffer Module. 

• A hardware Logic-State Trace Data module for the prototype system. 

• A set of user commands for debugging the prototype system and its software. 

• AMPL Microprocessor Prototyping Language to support user commands. 

The operating system supplied for the Model 990 Computer equipped with floppy disks is the Terminal 
Executive (TX990). It supports the Terminal Executive Development System (TXDS) that includes 
the Text Editor, Assembler, and Link Utility. The computer, TX990, and floppy disks also support the 
AMPL program which implements the user commands. Floppy disk units provide the user with a high- 
speed, random access storage medium on which the user can develop programs using the Text Editor, 
Assembler, and Link Utility. In addition, the debugging environment (including prototype programs) 
can be saved on and restored from diskette files. 

The operating system supplied with the DS990 disk system is the Disk Executive, DX 10, Release 3. It 
supports program development utilities including a text editor, a macro assembler, a FORTRAN 
compiler, a COBOL language processor, a BASIC* interpreter, and a link editor. The computer, 
DX10, and the disk system also support the AMPL program that implements the user commands. The 
disk system provides the user with a high-speed, random access storage medium on which the user can 
develop programs using the program development capabilities. In addition, the debugging 
environment (including prototype programs) can be saved on and restored from disk files. 

The emulator hardware includes a buffer module for the microprocessor to be used in the user's 
prototype system (target system). The emulator with the appropriate buffer module replaces the 
microprocessor of the target system. The emulator also provides memory and control circuitry 
required to execute software in the target system under control of the AM PL software. The emulator 
memory consists of a 256-word trace memory and a 4K-word user memory. The control circuitry 
allows the emulator to halt processing on specified program conditions (breakpoints) and to store 
memory or instruction addresses in the trace memory. The host computer (Model 990 Computer in 
which AMPL software executes) can halt the emulated microprocessor and access and modify 
memory in the target system. 

The trace module contains a 256 by 20-bit memory that stores up to 256 20-bit words that can be read 
by the host computer. The 20 bits may be connected to the address or memory bus through the 
emulator module or directly to test points in the target system using data probes. Four of the lines are 
equipped with latches that can change state on fast pulses as narrow as approximately 10 ns duration. 


* I rademark of Trustees ot Dartmouth College. Hanover. N.H. 
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Four qualifier lines select data words to be traced, and an event counter counts traced words that 
match a specified data word. Both the qualifiers and the data are masked to allow the user to specify 
any qualifiers and data bits to be used in the selection. The event counter, together with the delay 
counter, generates a signal that may be used to terminate the trace. Alternatively, a signal that the trace 
memory is full may be used to terminate the trace. Termination of the trace may either interrupt the 
host computer or signal the emulator to halt the microprocessor. 

1.2 TYPICAL PROTOTYPE DEVELOPMENT CYCLE 

Figure 1-1 shows the use of the laboratory during development of the software and integration of 
software into the prototype system. First, the software development capabilities executing in the host 
computer are used to obtain an object module. The source code is prepared and assembled using the 
text editor and assembler. When assembler errors are detected, the text editor is used to correct the 
source code and the source code is reassembled. When all errors that the assembler can detect have 
been corrected, the resulting object module is linked with other required object modules, if any, to 
obtain a linked object module. Source code for one or more modules may be corrected and 
reassembled if the link utility detects an error. When the linking operation detects no errors, the linked 
object module is ready to be loaded into memory of the target system. Alternatively, the module may 
be loaded into user memory or trace memory of the emulator module as appropriate. 

The user may enter commands and A M PL statements to initialize trace and breakpoint conditions for 
testing the software and prototype system, and to start the emulator. When a breakpoint halts the 
emulator, the user may enter commands to inspect the results of the test. When the results are not 
correct, the user may correct the source code, reassemble and relink. Or the user may make corrections 
in the object code in target system memory. The user may also continue testing until the prototype 
system is thoroughly tested, and all areas of the software have been executed. When the software has 
been thoroughly tested, the user may execute the PROM Programmer Utility to manufacture 
firmware. 

1.3 OPERATIONAL FEATURES 

Figure 1-2 shows an AMPL configuration consisting of a trace module and an emulator module under 
control of a host computer connected to a target system by cables from the buffer module and from the 
trace module. The buffer module cables connect to the microprocessor socket in the target system, and 
the trace module cables connect to signals being traced in the target system. 

The lab provides the following operational features: 

• The user may load the target program into emulator memory or target memory or a 
combination of both. 

• The user substitutes the emulator for the microprocessor in the target system, and thus 
monitors the flow of execution of the target program in the target system. 

• The host processor monitors interrupts from both the emulator module and the trace 
module(s). 

• The user may inspect and modify the contents of memory and registers in the target system, 
the emulator module, and the trace module(s). 

• The user may save and restore the environments of debug sessions to continue the debug 
operation at a later time. 

• The user may enter user commands to control the debug operation. 
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Figure 1-1. Typical Prototype Development Cycle 
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1 4 SOFTWARE CONFIGURATION 

Software required for the laboratory system is as follows: 

• AMPL Software 

• PROM Programmer Utilities 

For a TX990 system, the additional software is: 

• TX990 Operating System 

• TXDS Development System 

• TXM1RA Assembler 

• TXEDIT Text Editor 

• TXL1NK Link Utility 

• TXLNK Link Editor Utility 

For a DX10 system, the additional software is: 

• DX10 Operating System 

• SDSMAC Macro Assembler 

• SDST1E Text Editor 

• SDSLNK Link Editor 
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SECTION II 

SYSTEM HARDWARE INSTALLATION 


2.1 GENERAL 

This section provides instructions for site planning, installation, and initial checkout of the 
emulator buffer modules and the logic-state trace data module when employed with either a FS990 or 
DS990 system tor 1 MS 9900 or I MS 9980 microprocessor hardware and software development. 


2.1.1 SYSTEM CONFIGURATION. A typical AMPL Microprocessor Prototyping Laboratory is 
shown in figure 2-1 . Several options of peripheral equipment are available for use with the system to 
assist with checkout and debug of the target system. In all cases the trace module and the emulator 
are installed in the Model 990 Computer chassis (990/4 or 990 / 10 . or an expander chassis) and are 
cabled in one of several alternate configurations to suit the target system under test. In figure 2-1. 
the microprocessor connector from the buffer module is installed in the target system in place of 
the microprocessor: the other cables from the buffer module are connected to the emulator module 
installed in the 990 computer chassis. 

2.1.2 SYSTEM COMPONENTS. lypical components of an AMPL Microprocessor Prototyping 
Laboratory are shown in figure 2-2. I he trace module and the emulator module are shown installed in 
a Mode! 990 Computer chassis Optional connections to the target system are: 

1. From the emulator via the buffer module, target connect, and the interconnecting cables. 
Components associated with the emulator are shown in figure 2-3. 

2. From the trace module via the trace data probe cable, the terminator box, and the probe 
leads equipped with either female connector pins or 1C test clips. Components associated 
with the trace module are shown in figure 2-4. 

A summary of the components shown in figures 2-3 and 2-4 are listed in table 2-1. along with the 
associated part numbers for each. 

2.2 SYSTEM INSTALLATION 

2.2.1 COMPUTER CHASSIS OPTIONS AND PREPARATIONS 

CAUTION 

Before removing or installing circuit boards and cables, be sure power 
is off since voltage transients can damage components parts. 

The CRU base address that the software uses to address and control the prototyping laboratory system 
is determined by the physical location of the emulator module and the trace module in the 990 
computer chassis, or in a CRU expander chassis. Since there are several different combinations of 
options for these installations, the user and programmer should decide upon the chassis slot locations, 
the CRU base address, and the interrupt level for both of these modules before installing them. 
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Figure 2-1. Typical AMPL Microprocessor Prototyping Laboratory 
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Figure 2-3. Emulator/Buffer and Interconnect Cables 


There are four typical FS990 system configurations, two of which use the Model 91 1 Video Display 
Terminal (VDT) and two of which use the Model 913 VDT. Figure 2-5 shows the standard 
configuration, using a Model 990/4 Computer and the Model 91 1 VDT. Figure 2-6 shows the same 
peripherals and a Model 990/ 10 Computer. Figure 2-7 shows the typical configuration using a Model 
990/4 Computer and a Model 913 VDT. Figure 2-8 shows a similar configuration using a Model 
990/ 10 Computer with the same peripherals. If the prototyping laboratory system is received with the 
modules installed in the standard configurations, the CRU base addresses have been established at the 
factory and are compatible with the software package. Also, in that case, the correct interrupt levels 
have been determined and prewired in the interrupt jumper plugs for the peripherals. No alterations or 
modifications of the 990 computer chassis is required. Other configurations are available from Texas 
Instruments to modify existing FS990 systems to suit user requirements. 

A DS990 system that supports the AMPL laboratory requires a Model 990/10 Computer 13-slot 
chassis with a disc drive system. The Model 91 1 VDT controller, emulator, and trace module may be 
installed in the main chassis as shown in figure 2-9, or in a CRU expansion chassis. The main chassis 
configuration for use with an expansion chassis is shown in figure 2-10, and the expansion chassis is 
shown in figure 2-1 1. A 91 1 VDT for another work station may be connected to the controller board, 
and the emulator and trace modules for the station may be installed in slots 12 and 13. 

If the prototyping laboratory system is received with the modules installed in the recommended 
computer configuration, the CRU base addresses for the modules in the computer chassis have been 
established at the factory and are compatible with the software package. Also, in that case, the correct 
interrupt levels have been determined and prewired in the interrupt jumper plugs. The CRU base 
addresses of the modules in the expansion chassis are determined by the plug on the CRU expander 
board to which the chassis is connected, and the slots into which the modules are connected. The 
interrupt levels are prewired in the interrupt jumper plug. 
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Table 2-1. AMPL Microprocessor Prototyping Laboratory 


Component: 


Part Number 


Emulator Module 
I MS 9900 Buffer Assembly 
Emulator Buffer Cable 
Emulator, Buffer Cable 
Buffer; Target Cable 
Buffer Target Cable 
Buffer/ Target Clock Cable 
TMS 9900 Target Connector 
TMS 9900 Buffer Module 
TMS 9980 Buffer Assembly 
Emulator Buffer Cable 
Emulator/ Buffer Cable 
Buffer/ Target Cable 
Buffer/ Target Cable 
TMS 9980 Target Connector 
TMS 9980 Buffer Module 
Trace Module 

Emulator, Trace Data Cable 
Emulator/ Trace Control Cable 
Trace Data Probe 


949925-0001 

949937-0001 

949924-0001 

949924-0002 

949923-0001 

949923-0002 

949945-0001 

949905-0001 

949995-0001 

949937-0002 

949924-0001 

949924-0002 

949923-0003 

949923-0004 

949955-0001 

949940-0001 

949910-0001 

949935-0001 

949936-0001 

949915-0001 


CHASSIS 
SLOT 
NIJM BLR 

1 

2 

3 

4 

5 

6 

7 

8 
9 

1 O 
1 1 
1 2 


1 3 


PI P2 


CPU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

N/A 

990/4 AU W8/K 

N/A 

N/A 

990/4 AU W/8K 

N 'A 

0 2EO 

40 K 990/4 MEMORY 
EXPANSION 

N/A 

0 2C0 

40 K 990/4 MEMORY 
EXPANSION 

N A 

O 2A0 

8K 990/4 MEMORY 
EXPANSION (OPT.) 

N/A 

0280 

8K 990/4 MEMORY 
EXPANSION (OPT. ) 

N A 

0 260 

SPARE 

N/A 

0240 

SPARE 

N/A 

0 2 20 

SPARE 

N/A 

0200 

SPARE 

N A 

0 1EO 

SPARE' 

N/A 

O ICO 

SPARE 

N 'A 

O t AO 

SPARE 

N/A 

O 1 80 

SPARE 

N A 

0 160 

EMULATOR 

module 

6 

O 1 40 

EMULATOR 

MODULE 

6 

0 120 

TRACE MODULE 

6 

O 100 

TRACE MODULE 

6 

OOEO 

9 1 1 VDT 
CONTROLLER 

3 

OOCO 

9 1 1 VDT 
CONTROLLER 

3 

0 OA 0 

FLOPPY DISC 
CONTROLLER 

7 

0080 , 

FLOPPY DISC 
CONTROLLER 

7 

0 0 60 

LINE PRINTER 
(OPTIONAL) 

6 

0040 

CARD READER 
(OPTIONAL) 

4 

0 0 20 

PROM PROGRAM- 
MER (OPTIONAL) 

6 

OOOO 

733 ASR 
(OPTIONAL) 

6 


(A) 1 37447 

Figure 2-5. Model 990/4 Computer 13-Slot Chassis, Standard Configuration, 
TX990 with 911 VDT 
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p t 


P2 


CHASSIS 
SLOT 
NUM BER 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

1 

N/A 

990/1 O/AU 2 

N/A 

N/A 

990/1 O/AU 2 

N/A 

2 

0 2E0 

990/ 1 O/AU 1 

N/A 

0 2C0 

990/1 O/AU 1 

N/A 

3 

0 2AO 

1 6K MEMORY 
EXPANSION 

N/A 

0280 

1 6K MEMORY 
EXPANSION 

N/A 

4 

0260 

48K MEMORY 
EXPANSION 

N/A 

0240 

48K MEMORY 
EXPANSION 

N/A 

5 

0220 

SPARE 

N/A 

0200 

SPARE 

N/A 

6 

0 1 EO 

SPARE 

N/A 

0 ICO 

SPARE 

N/A 

7 

0 1 A0 

SPARE 

N/A 

0 1 80 

SPARE 

N/A 

8 

0 160 

EMULATOR 

MODULE 

6 

0 1 40 

EMULATOR 

MODULE 

6 

9 

0 1 20 

TRACE MODULE 

6 

0 100 

TRACE MODULE 

6 

1 0 

00E0 

9 1 1 VDT 
CONTROLLER 

3 

OOCO 

9 1 1 VDT 
CONTROLLER 

3 

1 1 

00A0 

FLOPPY DISC 
CONTROLLER 

7 

0080 

FLOPPY DISC 
CONTROLLER 

7 

1 2 

0060 

LINE PRINTER 
(OPTIONAL) 

6 

0040 

CARD READER 
(OPTIONAL) 

4 

1 3 

0020 

PROM PROGRAM- 
MER (OPTIONAL) 

6 

0000 

7 33 ASR 
(OPTIONAL) 

6 

— — ■— 


(A)1 37448 


Figure 2-6. Model 990/10 Computer 13-Slot Chassis Configuration for TX990 with 911 VDT 


PI p 2 


CHASSIS 
SLOT 
NUM BER 

CRU 

BASE 

ADDRESS 

Cl RCU IT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER— 
RU PT 
LEVEL 

1 

N/A 

990/4 AU W/8K 

N/A 

N/A 

990/4 AU W 8K 

N/A 

2 

02E0 

40 K 990/4 MEMORY 
EXPANSION 

N/A 

02C0 

40 K 990 4 MEMOR1 
EXPANSION 

N A 

3 

0 2A0 

8 K 990/4 MEMORY 
EXPANSION (OPT. ) 

N/A 

0 28 0 

8K 990/4 MEMORY 
EXPANSION (OPT. ) 

N A 

4 

0260 

SPARE 

N/A 

0240 

SPARE 

N/A 

5 

0220 

SPARE 

N./A 

0200 

SPARE 

N A 

6 

0 1E0 

SPARE 

N/A 

0 1 CO 

SPARE 

N A 

7 

0 1 AO 

SPARE 

N/A 

0 1 80 

SPARE 

N A 

8 

0 1 60 

EMULATOR 

MODULE 

4 

0 1 40 

EMULATOR 

MODULE 

4 

9 

0 1 20 

TRACE MODULE 

4 

0 100 

TRACE MODULE 

4 

1 0 

00E0 



9 1 3 VDT 
CONTROLLER 

3 

OOCO 

9 1 3 VDT 
CONTROLLER 

3 

1 1 

OOAO 

FLOPPY DISC 
CONTROLLER 

7 

0080 

FLOPPY DISC 
CONTROLLER 

7 

1 2 

0060 

LINE PRINTER 
(OPTIONAL) 

4 

0040 

SPARE 

4 

1 3 

0020 

PROM PROGRAM- 
MER (OPTIONAL) 

N/A 

0000 

733 ASR 
(OPTIONAL) 

6 


(A)1 37449 

Figure 2-7. Model 990/4 Computer 13-Slot Chassis Configuration for TX990 with 913 VDT 
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CHASSIS 
SLOT 
NUM BER 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

1 NTER— 
RUPT 
LEVEL 

1 

N/A 

990/1 0/AU2 

N/A 

N/A 

990/ 1 O/AU 2 

N/A 

2 . 

0 2 EO 

990/1 O/AU 1 

N/A 

0 2 C 0 

990/1 O/AU 1 

N/A 

3 

0 2.A0 

1 6 K MEMORY 
EXPANSION 

N/A 

0280 

1 6 K MEMORY 
EXPANSION 

N /A 

4 

0260 

48K MEMORY 
EXPANSION 

N/A 

0240 

4 8 K MEMORY 
EXPANSION 

N/A 

5 

0 220 

SPARE 

N/A 

0 20 0 

SPARE 

N/A 

6 

O 1E0 

SPARE 

N/A 

0 ICO 

SPARE 

N/A 

7 

0 1 A0 

SPARE 

N/A 

0 1 80 

SPARE 

N/A 

6 

O 160 

EMULATOR 
MODU LE 

4 

0 1 40 

EMULATOR 
MODU LE 

4 

9 

0 120 

TRACE MODULE 

4 

0 1 00 

TRACE MODULE 

4 

1 0 

00E 0 

9 1 3 VDT 
CONTROLLER 

3 

ooco 

9 1 3 VDT 
CONTROLLER 

3 

1 1 

OOAO 

FLOPPY DISC 
CONTROLLER 

7 

0080 

FLOPPY DISC 
CONTROLLER 

7 

1 2 

0060 

LINE PRINTER 
(OPTIONAL) 

4 

0040 

CARD READER 
(■OPTIONAL) 

4 

1 3 

0 0 20 

PROM PROGRAM- 
MER (OPTIONAL) 

N/A 

0000 

7 33 ASR 
(OPTIONAL) 

6 


(A) 1 37450 


Figure 2-8. Model 990/10 Computer 13-Slot Chassis Configuration for TX990 with 913 VDT 


CHASSIS 
SLOT 
NUM BER 

1 

2 

3 

4 

5 

6 

7 

8 
9 

t 0 
1 1 
1 2 
1 3 

(A' 1 3745 


P 1 P2 


CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

N/A 

990/1 O/AU 2 

N/A 

N/A 

990/1 O/AU 2 

N/A 

02EO 

990/1 O/AU 1 

N/A 

0 2 C 0 

990/1 O/AU 1 

N/A 

0 2 A 0 

1 6K MEMORY 
EXPANSION 

N/A 

0280 

t 6 K MEMORY 
EXPANSION 

N/A ; 

0260 

48K MEMORY 
EXPANSION 

N/A 

0240 

48K MEMORY 
EXPANSION . 

N/A 

0220 

1 6 K MEMORY 
EXPANSION 

N/A 

0200 

1 6 K MEMORY 
EXPANSION 

N/A 

0 1E0 

4 8 K MEMORY 
EXPANSION 

N/A 

0 ICO 

48K MEMORY 
EXPANSION 

N/A 

0 1 AO 

DISC CONTROLLER 

1 3 

0 1 80 

DISC CONTROLLER 

1 3 

0 160 

MAG. TAPE CONTR. 
ORTILINE COUPLER 

9 

0 1 40 

MAG, TAPE CONTR 
OR T 1 LI N E’COU P LE R 

9 

0 1 20 

9.1 1 VDT . 
CONTROLLER 

8 

0 100 

9 1 1 VDT 
CONTROLLER 

1 0 

00E 0 

EMULATOR 
MODU LE 

1 2 

OOCO 

EMULATOR 

MODULE 

1 1 

OOAO 

TRACE MODULE 

3 

0080 

TRACE MODULE 

7 

0060 

LINE PRINTER 
(OPT IONAL : 

1 4 

0040 

CARD READER 

(OPTIQNAU 

4 

0020 

PROM PROGRAM- 
MER (OPTIONAL) 

1 5 

0000 

7 33 ASR 
(OPTIONAL) 

6 


1 


Figure 2-9. Model 990/10 Computer 13-Slot Chassis Recommended DX10 Configuration 

without CRU Expansion Chassis 


2-8 


Digital Systems Division 




946244-9701 



CHASSIS 

SLOT 

NUMBER 

1 

2 

3 

4 

5 

6 

7 

8 
9 

11 0 

I 1 

12 

1 3 


PI P2 


CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

N/A 

990/10 AU2 

N/A 

N/A 

990/1 0 AU 2 

N/A 

02 EO 

990/10 AU 1 

N/A 

02C0 

990/1 0 AU 1 

N/A 

02 AO 

1 6K MEMORY 
EXPANSION 

N/A 

0280 

1 6K MEMORY 
EXPANSION 

N/A 

0260 

4 8 K MEMORY 
EXPANSION 

N/A 

0240 

48K MEMORY 
EXPANSION 

N/A 

0220 

1 6K MEMORY 
EXPANSION 

N/A 

0200 

1 6K MEMORY 
EXPANSION 

N/A 

01 EO 

48K MEMORY 
EXPANSION 

N/A 

01 CO 

48 K MEMORY 
EXPANSION 

N/A 

01 AO 

DISK CONTROLLER 

1 3 

0180 

DISK CONTROLLER 

1 3 

0160 

MAG. TAPE CONTR. 
OR TILINE COUPLER 

9 

0140 

MAG. TAPE CONTR. 
OR Tl LINE COUPLER 

9 

0120 

911 VDT 
CONTROLLER 

8 

0100 

91 1 VDT 
CONTROLLER 

10 

00 EO 

91 1 VDT 
CONTROLLER 

1 2 

OOCO 

91 I VDT 
CONTROLLER 

1 1 

00 AO 

CRU EXPANDER 

3 

0080 

CRU EXPANDER 

7 

00 60 

LINE PRINTER 
(OPTIONAL) 

I 4 

0040 

CARD reader: 
(OPTIONAL) 

4 

0020 

PROM PROGRAM- 
MER (OPTIONAL) 

1 5 

0000 

733 ASR N 
(OPTIONAL) 

6 


(A) 1 37452 


Figure 2-10. Model 990/10 Computer 13-Slot Chassis Recommended DX10 Configuration with 

CRU Expansion Chassis 


CHASSIS 

SLOT 

NUMBER 

1 

2 

3 

4 

5 


6 

7 

8 
9 

1 0 
1 I 
1 2 
1 3 


(A) 13745 


PI P2 


CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

INTER- 

RUPT 

LEVEL 

CRU 

BASE 

ADDRESS 

CIRCUIT BOARD 

1 N TER - 
RUPT 
LEVEL 

N, A 

CRU BUFFER 

N/A 

N/A 

CRU BUFFER 

N/A 

06E0 

Tl LINE COUPLER 
(OPTIONAL) 

N/A 

0 6C0 

TILINE COUPLER 
(OPTIONAL) 

N A 

06 AO 

SPARE 

N/A 

0680 

SPARE 

N A 

0660 

SPARE 

N/A 

0640 

SPARE 

N/A 

0620 

SPARE 

N/A 

0600 

SPARE 

N/A 

05E0 

SPARE 

N/A 

0 5C0 

SPARE 

N-A 

05 AO 

DISK CONTROLLER 
(OPTIONAL) 

1 3 

0580 

Dl SK CONTR . OR 
LINE PRINTER(OPT) 

1 3 

0560 

MAGNETIC TAPE 
CONTROLLER (OPT.) 

9 

0540 

MAGNETIC TAPE 
CONTROLLER (OPT.] 

9 

0520 

9 1 1 VDT 
CONTROLLER 

8 

0 50 0 

9 1 1 VDT 
CONTROLLER 

10 

04E0 

EMULATOR 

MODULE 

1 2 

0 4C0 

EMULATOR 

MODULE 

1 1 

04 AO 

TRACE MODULE 

3 

0480 

TRACE MODULE 

7 

0460 

EMULATOR 
MODU LE 

1 4 

0440 

EMULATOR 

MODULE 

4 

0420 

TRACE MODULE 

1 5 

0400 

TRACE MODULE 

6 


NOTE: THE CRU BASE ADDRESSES SHOWN APPLY TO EXPANSION CHASSIS 1 (CONNECTED 
TO P3 OF CRU EXPANDER BOARD). ADD (N ■■ 1) X 400, 6 TO THE ABOVE ADDRESSES 
FOR CRU BASE ADDRESSES IN EXPANSION CHASSIS N. 


Figure 2-11. Model 990/10 Computer 13-Slot CRU Expansion Chassis Recommended DX10 Configuration 
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2.2. 1.1 Interrupt Levels. If the trace and emulator modules are obtained as separate kits to be installed 
in an existing computer system, new i nterrupt level connections must be made in the computer chassis 
and in the expansion chassis for proper interrupt recognition by the program. 

CAUTION 

Ensure that ac power to the computer chassis has been disabled before 
beginning this procedure. 

2.2. 1.2 Interrupt Connections and Modifications. Wiring in the backplane of the chassis connects 
interrupt lines from each circuit board connector to a pair of jumper plugs located on the backplane 
adjacent to slot number 1, as shown in figure 2-12. Jumper wires installed in these jumper plugs connect 
the interrupt output lines from the circuit boards to the CRU interrupt inputs. In the expansion 
chassis, similar plugs connect the interrupt output lines from the circuit boards to the interrupt inputs 
of the CRU buffer module. 

Figure 2-13 is an outline drawing of the jumper plugs for the 13-slot chassis and the 6-slot chassis. 
Interrupt levels are shown at the right of each connector. The 990/4 computer does not recognize 
interrupt levels 8 through 15. Two jumper positions are wired to each chassis interrupt line. This allows 
multiple interrupts to be connected to one interrupt level. To make interrupt level modifications 
perform the following steps: 

1. Remove the circuit boards from the first five slots of the chassis to gain access to the 
interrupt jumper plugs. 


IN ERRUPT JUMPER PLUGS 



(A) 1 33096A 


Figure 2-12. Location of Interrupt Jumper Plugs (6— and 13— Slot Chassis) 
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6~ SLOT 

CHASSIS INTERRUPT 
JUMPER PLUG 



JUMPER WIRE 
EDGE VIEW 


6P2 

□ □ 

6P2 

□ □ 

5P2 

□ □ 

5P2 

□ □ 

4 P 2 

□ □ 

4 P 2 

□ □ 

3P2 

□ □ 

3P2 

□ □ 

2P2 

□ □ 

LOCATION 2P2 

□ □ 


1 A1 J2 

6 

7 

8 
9 

1 0 
1 1 
1 2 
1 3 
1 4 

LEVEL 15 


(A)1 34179 


1 3-SLOT 

CHASSIS INTERRUPT 
JUMPER PLUG 

LOCATION 2P1 
2P1 
3P1 
3P1 
4 P ‘ 

4 P ‘ 

5P ' 

5P 1 
6P 
6P ' 

7 P ' 

7 P ' 

8P 
8P 
9P 
9 P 
1 OP 
1 OP 
1 1 P 
1 1 P 
1 2P 
1 2P 
1 3P 
1 3P 


ALTERNATE 1 3~SLOT 
CHASSIS INTERRUPT 
JUMPER PIN 
CONFIGURATION 


2P 1 

0 

o 

2 P 1 


3P 1 

o 

O 

3P 1 


4 P 1 

o 

o 

4 P 1 


5P 1 

o 

o 

5P 1 


6P 1 

o 

o 

6P1 


7P 1 

o 

o 

7 P 1 


8P1 

o 

o 

8P 1 


9P 1 

o 

o 

9 P 1 


1 OP 1 

o 

o 

1 OP 1 


1 1 P 1 

o o 

IIPI 

o 

LEVEL 

1 2P 1 

o o 

12 Pi 

o 

LEVEL 

1 3P 1 

0 o 

1 3 PI 

o 

LEVEL 


□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

D 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

a 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 


JUMPER WIRE EDGE VIEW 


1 3P2 

□ 

□ 

1 A 1 J2 

4 

1 3P2 

□ 

□ 

5 

1 2P2 

□ 

□ 

6 

1 2P2 

□ 

□ 

7 

1 1 P 2 

□ 

□ 

8 

1 1P2 

□ 

□ 

9 

1 OP 2 

□ 

□ 

1 0 

1 0P2 

a 

□ 

1 1 

9P2 

□ 

□ 

1 2 

9P2 

□ 

□ 

1 3 

8P2 

□ 

□ 

1 4 

8P2 

□ 

□ 

LEVEL 1 5 

7P2 

□ 

□ 


7 P 2 

□ 

□ 


6P2 

□ 

□ 


6P2 

□ 

□ 


5P2 

□ 

□ 


5P2 

□ 

□ 


4P2 

□ 

□ 


4 P 2 

□ 

□ 


3P2 

□ 

n 


3P2 

□ 

□ 


2P2 

□ 

□ 


2P2 

□ 

□ 



1 3P2 

o 

o 

»3P2 

o 

1 2P2 

o 

o 

I2P2 

o 

1 1 P2 

o 

o 

1 1 P 2 

o 

1 QP 2 

o 

o 

I0P2 

o 

9P2 

o 

o 

• P2 

o 

8P2 

o 

o 

• P2 

o 

7P2 

o 

o 

7P2 

o 

6P2 

o 

o 

• P2 

o 

5P2 

o 

o 

3P2 

o 

4P2 

o 

o 

4P2 

o 

3P2 

o 

o 

3P2 

o 

2P2 

o 

O 

*P2 

o 


LEVEL 4 


0 


8 

9 

1 0 
1 1 
1 2 
1 9 
1 4 

LEVEL 1 5 


Figure 2-13. 6- and 13- Slot Chassis Interrupt Jumper Plugs 
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2. Use one of the following steps to connect the jumper wires. 


a. Pluggable jumpers. Remove the jumper plugs from the chassis. Insert the specially- 
constructed jumper wire to connect the interrupt level to the chassis slot interrupt pin. 

b. Jumper pins. Connect a jumper wire from the interrupt level pin to the chassis slot 
interrupt pin. 

3. Reinstall the jumper plugs and then reinstall the circuit boards. 

For additional information about interrupt connections, refer to the Model 990/4 Computer System 
Hardware Reference Manual or the Model 990/ 10 Computer System Hardware Reference Manual. 

2.2.2 CIRCUIT BOARD INSTALLATION. When the proper locations in the computer chassis for 
the emulator and trace modules have been determined and the correct interrupt levels established, 
install the modules in the computer chassis in the following manner: 

1 . Ensure that computer power is off. 

2. Insert the circuit board, component side up, into the selected slot so the board slides into the 
card guides on either side of the slot. 

3. Push the board straight in until the edge connector engages the connector in the backplane. 
Verify that the guide slots i n the circuit board mate properly with the alignment comb in the 
chassis. 

2.2.3 CABLE CONNECTIONS. When the circuit boards have been installed in the appropriate 
chassis slot, install the cables for the particular configuration in which they are to be used. The AM PL 
Microprocessor Prototyping Laboratory can utilize one emulator/ buffer as shown in figure 2-14, or 
one trace module as shown in figure 2-20, or both an emulator/ buffer and a trace module as shown in 
figure 2-23. To install a plug/ receptacle, be sure that the embossed arrowheads are aligned for correct 
orientation before mating the pair together, then align the pins, match the connectors together evenly, 
and press on the plug until it is firmly seated. 


NOTE 

Pin 1 of the connector is on the same side as the red stripe on the ribbon 
cable. 

2.2.3. 1 Installing Emulator/ Buffer Cables. The emulator works in conjunction with the buffer module 
to replace the microprocessor and/or the program memory in the user’s target system. The buffer 
module houses the microprocessor and completes the interface between the emulator and the target 
system. 

Two ribbon cables are routed from the buffer module to the emulator, and three other ribbon cables 
(two forTMS 9980) are routed between the buffer module and the target connector. The configuration 
of these cable connections is shown in View A and B of figure 2-14. 

Install the cables from the buffer module to the emulator as shown in the illustration. The location ol 
the connectors on the emulator module are as shown in figure 2-15. When installing connectors, be sure 
the embossed arrowheads on the ’plug and the receptacle have the same orientation, as shown in figure 
2-16. Since one of the mating connectors is slightly inset on the emulator circuit board, these 
connections should be made before the emulator board is fully inserted into the computer chassis 
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Figure 2-14. Emulator/Buffer Cabling Diagram 
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CABLE TO 



EMULATOR MODULE 
BOARD EDGE 


(A)1 36566 


Figure 2-16. Cable Connections at Emulator 


backplane connectors. Attach the emulator/ buffer cable connectors, P5 and P6, to the emulator 
module connectors P5 and P6, respectively, then slide the emulator into the chassis backplane 
connectors. When the backplane connectors are fully engaged, the two plastic ejectors on the outer 
corners of the emulator board should settle in place against the frame. 

2.23.2 Installing Target System Connectors. The three cables from the TMS 9900 buffer module are 
installed in the target system connector as shown in figure 2-17. Connect P2 to J2, P3 to J3, and P4 to 
J4. Be sure the orientation of the plugs is as shown in the illustration (i.e., the embossed arrowhead on 
the plugs is adjacent to pin 1). 
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PIN 1 

or j 2 


GROUND 
TIE POINT 


(A ) 1 36567A 


Figure 2-17. Installation of Buffer Cables and Connector at TMS 9900 Target System 
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The connections for the TM S 9980 Buffer are similar, as shown in figure 2-18. Connect the two cables 
from the buffer module to the target system connector, P2 to P2, and P3 to P3. No clock cable or 
separate ground connection is required. Be sure the orientation of the plugs is as shown in the 
illustration (i.e., the embossed arrowhead on the plugs is adjacent to pin 1. 

When the system cables have been installed in the target system connector, remove the microprocessor 
chip Irom the target system breadboard and install the target connector in place of the chip. Be sure the 
beveled index corner of the connector (which identifies pin 1 of the microprocessor chip) has the 

correct orientation, as shown in figure 2-17 and 2-18. 


Next, (TMS 9900 buffer only) connect the ground lead to a good target system ground, preferably near 
the microprocessor socket. 

When all of the connections have been made, insert a slot screwdriver into the cutout of the buffer 
module cover and select either an INTERNAL prototyping system CLOCK or the TARGET SYS 
external clock (figure 2-19). 

2.2.33 Installing Trace Module Cables. If a trace module is to be used alone, install the trace data 
probe as shown in figure 2-20. This general-purpose data probe is implemented on a 6-foot ribbon 
cable with an edge connector on one end and a terminator box on the other end. Each of the 26 signal 
channels in this cable (plus two ground leads) are extended from the terminator box via color-coded 
probe leads, as shown in figure 2-2 1 . Each probe lead has a female connector on its outboard end, sized 
to lit a standard wire-wrap post. Special spring-loaded IC test clips that accommodate the probe leads 
are available from suppliers, and these IC test clips may be used for convenient attachment to any IC 
element, as shown in figure 2-22. 

2.23.4 Connecting Emulator and Trace Module. The emulator and trace modules are cabled together 
as shown in figure 2-23. The interconnections consist of two, 4-inch jumper cables. The control cable is 
connected P3 to P3, and the data cable is connected P4 to P4. Verify that the embossed arrowheads on 
plugs P3 and P4 are aligned with pin 1 on connectors P3 and P4. Optionally, the jumper data cable may 
be omitted, if it is desired to trace data patterns directly from the target system. In this case, the trace 
data probe may be connected from the trace module to the target system as described in the preceding 
paragraph. 

2.3 PERIPHERAL EQUIPMENT FOR THE PROTOTYPING LABORATORY 

Many various options of peripheral equipment are available for installation in the AM PL 
Microprocessor Prototyping Laboratory. The most frequently used peripherals in a TX990 system are 
shown in figure 2-24, along with the interface board or controller and the cables for each type of 
equipment. Figure 2-25 shows similar information for a DXI0 system. 


2-17 


Digital Systems Division 


946244-9701 



( A) 1 37465 


Figure 2-18. Installation of Buffer Cables and Connector at TMS 9900 Target System 
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Figure 2-21. Trace Data Probe Terminator Box and Leads 
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Figure 2-22. Typical Connections to Target System 
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Figure 2-24. Peripheral Devices Available for AMPL 
Microprocessor Prototyping Laboratory (TX990) 
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SECTION III 
AMPL APPLICATIONS 

3.1 INTRODUCTION TO AMPL LANGUAGE 

Other parts of this manual describe in detail the syntax and usage of each element in the AMPL 
language. This section briefly outlines some of the capabilities of the language and describes 
some actual applications to development problems. 

Hie AMPL language is a complete test language which includes: 

• integer arithmetic 

• logical operators 


• arithmetic (two’s complement) and unsigned magnitude relation operators 

• execution control and branching structures 

• procedure and function declarations which facilitate design of routines and subroutines 

• library procedures and functions especially designed to facilitate the gathering and 
display of test data 

• user-controlled display formats - binary, decimal, hexadecimal, octal, ASCII, and flflOO 
assembly language mnemonics 

• emulator/buffer control commands 

• trace module control commands 

• utility functions. 

The AMPL language allows the user to initiate and control each test operation on an interactive 
basis, or to design and store extensive monitoring and testing procedures which execute without 
manual intervention. 

The examples of AMPL applications in this section utilize the trace module control commands, 
the emulator control commands, and some of the library procedures. 

The emulator and trace module commands are intimately related to the module hardware and 
the test connections (see Section II before proceeding). Briefly, the emulator and buffer connect 
a substitute microprocessor into the system under test (target system). The Emulator lias access 
to all the microprocessor input and output lines, including the CRU, address bus, data bus. 
memory control, clock and hold lines. This gives the emulator control of the target system, and 
access to the Program Counter (PC), Workspace Pointer (WP), and Status Register (ST). 
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3.1.1 EMULATOR CONTROL COMMANDS AND VARIABLES. The emulator module must be 
initialized before any type of emulator access may be executed. The HINT command initializes 
the emulator, specifying by device name which emulator is active. The HINT command is cnteied 
as follows: 

EINT (‘EMU 1 ) Initialize emulator EMU. 


The example uses a TX990 device name. The proper command for a DX10 system is as follows: 

E| V| (‘EMOI’) Initialize emulator EM01. 

Selection gates, controlled by a system variable HUM, allow the microprocessor access to a Sk-bvte 
emulator user memory or to the target system memory. The emulator has a 512-byte memory which 
may be assigned to the microprocessor or reserved for address tracing, as specified by a system variable 

ETM. 

The emulator has comparison logic which monitors the address bus. the Data Bus In (DBIN) line 
and the Instruction Acquisition ( IAQ) line and gives a comparison output when they match a 
predetermined value. This predetermined value is controlled by the emulator compare (EC MP) 
command. The ECMP command has an address field which selects the address to be checked, 
and a type field which determines whether the compare should be issued for instruction 
acquisitions only, write operations only, or all accesses to the specified address. I he type field 
can also be used to disable comparisons. 


The following examples show how to use the HCMP command. 


Command 


Compare Condition 


ECMP (ADDR. 0040) 

ECMP (ADDR+IAQ, 0004) 

or 

ECMP (IAQ. 0004) 

ECMP (ADDR-DB1N, 04EE) 


Any access to (hex) address 0040. 
Instruction acquistion access to 0004. 


Write operation performed at 04EE. 


or 

ECMP (-DBIN, 04EE) 

ECMP (OFF) None. Emulator comparison disabled. 

The emulator internal comparison can be selected as the triggering event for a breakpoint. This 
requires two instructions, one which defines the comparison as an “event” and one which selects 
the event as a breakpoint and specifies action alter the breakpoint occurs. 


The emulator event (F.HVT) command defines an event. To define the emulator comparison as 
an event, enter EEVT (INT). If EXT is used as a modifier, an event signal connected by the user 
is selected as the emulator event. 

The emulator breakpoint (EBRK.) command selects the breakpoint condition and the action to 
be taken when the breakpoint condition occurs. 

The breakpoint condition may be the event (EVT) defined by the EEVT command, or it may be 
the emulator trace buffer full (FULL) condition, or whichever occurs first. Note that the trace 
buffer full condition occurs when the number of samples specified in the ETRC command have 
been taken. This number is between 1 and 256. The OFF keyword disables the breakpoint. 

The breakpoint action may be either SELF (stop emulator) or OFF (do not stop emulator ). Break 
point action OFF causes the AMPL software to interrupt the host computer. 
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The following examples show how to use the EBRK command: 


Command 

EBRK (EVT, SELF) 

EBRK (FULL, OFF) 

EBRK (EVT+FULL, SELF) 
EBRK (OFF, OFF) 


Breakpoint Condition 

Event 

Trace Completion 
Event or Trace 
None 


Breakpoint Action 

Stop Emulator 
Interrupt Host Computer 
Stop Emulator 
None 


Figure 3-1 is a flowchart example which shows the steps in setting up an emulator comparison 
breakpoint with the ECMP, EEVT, and EBRK commands. 



ECM P( I AQ , < ADDRESS > ) 


ECMP(IAQ , < ADDRESS > ) 


EEVT ( 1 NT ) 


EBRK(EVT .SELF) 


I EBRK(E VT .SELF) 


(A) 1 36530 


Figure 3-1. Setting Emulator Comparison Breakpoint with ECMP, EEVT, EBRK 
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The emulator trace command allows selection of data samples to be stored in emulator trace 
memory. The form of the command is similar to the ECMP command. 

The first operand field of ETRC allows recording of all addresses accessed by the microprocessor 
(ADDR), only instruction acquisitions (ADDR+IAQ) or no trace (OFF). The second operand is a 
count of the number of samples desired. The count is limited by the 256-word capacity of the 
emulator trace memory. The third operand allows selection of internal clock from the butter 

board or external clock. 

The following examples show how to use the ETRC command: 

Command Trace Condition 


ETRC (ADDR, 256, INT) 


ETRC (ADDR+IAQ, 10, EXT) 


ETRC (IAQ, 50, INT) 


ETRC (OFF) 


Trace 256 memory bus addresses using 
internal (target system) clock enable. 

Trace 10 instruction addresses using 
external (trace module) clock enable. 

Trace 50 instruction addresses using in- 
ternal (target system) clock enable. 

Disable trace logic. 


Figure 3-2 is a flowchart which shows how to set up the ETRC command and use the emulator 
trace memory full as the breakpoint condition. 

Note that the emulator trace memory stores memory addresses as they appear on the micro- 
processor address bus. It does not store the data written to or read from these addresses. The 
trace module, when interconnected with the emulator by control and data cables, can store the 
data read from or written to these addresses. 

Addresses stored in trace memory are accessed as if they were elements in a single dimension 
array (ETB) using an index in parentheses. Index zero corresponds to the most recently st c 
address. Previously stored addresses are accessed using negative index values for example 
ETB(- 9). An index of — 1 corresponds to the address of the instruction preceding e one a 
most recently stored address. More negative index values correspond to previously store 
addresses and the oldest address is accessible at the most negative index value. System variable 
ETBO contains the index of the oldest address stored, and ETBN contains the index of the 
newest address stored in the emulator trace memory. 

The status of the emulator can be determined by entering EST. The resulting output is .a 
hexadecimal display. The least significant digit gives the status as tabulated in Section V ot t us 
manual. There is a library procedure, EST AT, which gives a plain text status printout. 

The emulator trace, if any, and microprocessor operation are initiated and halted by the ERUN 
and EHLT commands, respectively. 
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(A) 1 3653 1 


Figure 3-2. Setting Emulator Trace Breakpoint 


3.1.2 TRACE MODULE COMMANDS .AND VARIABLES. The trace module is also capable of 
tracing a maximum of 256 items, each consisting of up to 20 bits. The module stores the traced 
items in a 256 X 20 trace memory. The trace module can generate a signal when a specified 
number of items have been traced. The trace module also compares specified bits of each item to 
specified values, and generates an event signal when an equal comparison occurs. An event 
counter counts these signals, and starts counting delays when a specified number of events has 
occurred. Each item stored in trace memory after the events have been counted constitutes a 
delay; when the specified number of delays has occurred, the logic generates an event and delay 
completion signal. The breakpoint can stop the trace, signal the emulator to stop the micro- 
processor, or interrupt the host computer without stopping either the trace or the microprocessor. 
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The commands and system variables for the trace module closely parallel those which control the 
emulator. The TINT command must be entered first to initialize the trace module. The following 
is an example of a TINT command using the device name in the TX990 system supplied with 
the prototyping laboratory: 

TINT ('TRA 1 ) Initialize trace module TRA. 

For a DX10 system, the proper command is as follows: 

TINT (‘TM01’) Initialize trace module TM01. 


Figure 3-3 is a flowchart of the steps in setting up a trace operation in the trace module. 

The TTRC command in the flowchart specifies tracing all addresses that are instruction acquire 
addresses (IAQ true), generating a completion signal when the count of addresses has been 
traced. EXT specifies the external clock, which is target system clock from the emulator. The 
OFF operand could have been omitted because it applies in default when no operand has been 
entered previously. This operand controls latching the four high-order bits to store glitches, and 
should be OFF when the data cable is connected to the emulator. 

The following examples show how to use the TTRC command: 

Command Trace Condition 


TTRC(ADDR+IAQ, 14, EXT, OFF) 


TTRC (Q0+Q1 , 256, INT, ON) 


TTRC(DATA-DBIN, 25, EXT, OFF) 


TTRC(OFF, 256, EXT, OFF) 


Trace 14 memory bus addresses using external 
(target system) clock. Trace only instruction 
addresses (IAQ true), and trace with latches 
off. 

Trace 256 items to which probe leads are 
connected, using internal clock. Trace an item 
only when signals to which probe leads Q0 
and Q1 are connected are true. Enable latches 
on DO — D3 . 

Trace 25 memory data words using external 
(target system) clock. Trace only data that 
was written, and trace with latches off. 

Trace 256 words from emulator using external 
(target system) clock. Trace all data (qualifiers 
masked off) and trace with latches off. 


The TBRK command specifies that the trace completion signal is to be used to generate a 
breakpoint, and to signal the emulator to halt at completion of the current instruction. 


3-6 


Digital Systems Division 



1 

TTRC(ADDR+IAQ , <COUNT > .EXT .OFF) 
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The following examples show how to use the TBRK command: 


Command 


Breakpoint Condition 


Breakpoint Action 


TBRK(FULL, SELF) 


Trace Completion Stop tracing, interrupt host compu- 

ter. 


TBRK(EVT, EMU) 
TBRK(EVT+FULL, SELF+EMU) 


TBRK(FULL, OFF) 


Event and Delay Request emulator to halt. 

Completion. 


Event and Delay Stop tracing and request emulator to 

Completion or halt. 

Trace Completion. 


Trace Completion Interrupt host computer. 


Items are stored in trace memory in a manner similar to the manner in which addresses are stored in 
the emulator trace memory. Items are accessed as if they are elements in a single dimension array 
(TTB) using an index in parentheses. Two system variables, TTBO and TTBN, contain the index 
values for the oldest and newest items traced, respectively. 

Trace module status can be displayed by entering TST. The status value returned is a 4-digit 
hexadecimal number. The TSTAT library procedure prints the status in plain text. 

In order to save memory space in the host computer, the library procedures are not automatically 
available when the AM PL system is called up. A COPY command with the file name of the library 
procedure may be used to bring the procedure into memory. It remains available until the symbol table 
is cleared by a CLR command. Each library procedure is accompanied by a short tutorial which 
describes the use of the procedure and the values, if any, required in the procedure call. To print the 
information, the user must enter a LIST command (paragraph 5.5.2) prior to entering the COPY 
command. Figure 3-4 is a sample of a copy statement and the resulting printout. The printout may be 
suppressed by a LIST (OFF) command. In the figure, the TDATA procedure has been copied. 

This short section on emulator and trace module commands is intended to provide sufficient 
background to follow some actual examples of AMPL system use in the development environ- 
ment. Detailed descriptions of the AMPL commands are contained in Section V. 

3.2 PROTOTYPING LABORATORY INITIAL CHECKS 

When the buffer module is connected to a target system, it is possible for the target system to 
interfere with proper operation of the AMPL system. The following initial checks identity these 
types of troubles so that they may be corrected before proceeding with further testing of the 
target system: 

• Buffer module checkout 

• Target system address and data bus checkout 

• Target system clock checkout 

• Target system memory checkout. 
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LIST ('LOG') 

COPY ( ■' : TDUMP S /PRC ' ) 


TITLE: 

REVISION: 


TDATAs PRINT TRACE MODULE 

03/24/77 


SAMPLES 


ABSTRACT: 

TDATA PRINTS A SPECIFIED RANGE OF SAMPLES FROM THE TRACE MODULE 
TRACE BUFFER. THE SAMPLES ARE NOT INTERPRETED; ALL TWENTY BITS ARE 
PRINTED FOR EACH SAMPLE. 


? ... USAGE’ : 

? ... TDATA HAS ONE REQUIRED AND 
? ...ARGUMENT IS THE STARTING INDEX 
? ...ARGUMENT IS THE ENDING INDEX. 

? ...IS THE STARTING INDEX PLUS 29, 
? ...THAT MANY IN THE TRACE BUFFER. 
? ...TRACE MODULE IS HALTED. 

? DEFINING TDATA NL 


ONE OPTIONAL ARGUMENT. THE FIRST 
TO BE USED. THE OPTIONAL SECOND 
IF IT IS OMITTED, THE ENDING INDEX 
GIVING 30 SAMPLES, IF THERE ARE 
TDATA MAY BE CALLED WHENEVER THE 


? PROC TDATA< 1,2) BEGIN 

1? IF ARG 0 EG! 2 

1? THEN LOC 1 = ARG 2 

1? ELSE LOC 1 = ARG 1+29; 

1? IF LOC 1 GT TTBN 
1? THEN LOC 1 = TTBN; 

1? LOC 2 = 0; 

1? ' INDEX HIGH LOW 

1? HIGH LOW ; 

1? WHILE ARG 1 LE LOC 1 
1? DO BEGIN 

29 IF LOC 2 MOD 3 EQ 0 

29 THEN BEGIN 

: -r? ARG 1 : ND / 

99 END 

99 ELSE " 

2? LOC 2 = LOC 2+1; 

29 TTBH ( ARG 1 ) : H; 

2? TTB < ARG 1):HA; 

2? ARG 1 = ARG 1 + l; 

2 9 END; 


1? END 


HIGH 


...ENDING INDEX WAS GIVEN 
. . . NOT G I VEN 

. . .LIMIT ENDING INDEX 
...SET NEWLINE FLAG 

low ' ; 


...START A NEW LINE 

...TAB TO NEXT COLUMN 
. . . STEP THE FLAG COUNTER 
...DISPLAY SAMPLE 


(A) 1 36533 



Figure 3-4. Sample Library Procedure 
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3.2.1 BUFFER MODULE CHECKOUT. The buffer module checkout procedure should be 
executed before connecting the AMPL system to a target system to verify that the buffer 
module is operating satisfactorily. The procedure may also be executed at any time there is a 
doubt of the proper operation of the buffer module. Perform the following steps: 

1 . Install the emulator and buffer modules and connect the cables as described in Section II. 
If the trace module is to be used in testing the target system, connect the trace module as 
required. Do not connect the target connector to the target system 

2. Set the CLOCK switch on the buffer module to the INTERNAL position. 

3. Apply power to the AMPL system. 

4. Load the AMPL program as described in paragraph 5.2. 

NOTE 

The emulator Halt Acknowledge indicator (figure 2-16) should be 
on at this point. If not, perform maintenance on the emulator 
module before continuing the test. 

5. Enter the EINT command to select the emulator. The following is an example of an EINT 
command. Substitute the device name of the emulator if EMU or EMDI is not the device 
name. 

? EINT (‘EMU’) Select emulator EMU (TX990). 

7EINT (‘EMOI’) Select emulator EMO! (DX10). 

6. Enter the following statement to map emulator user memory into the address space: 

7. Enter the following command to make library procedure ESTAT available: 

? COPY (‘.S#SYSLIB. AMPLSLIB.STAT’) For DX10. 

8. Call library procedure ESTAT. The following is an example of the call and the 
resulting display: 

? ESTAT: 

EMULATOR IS NOT EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

35 BREAKPOINTS COUNTED. 

10 ADDRESSES TRACED: -9 . . . 0 

9 . The emulator should not be executing at this point. If the emulator is executing 
perform maintenance on the emulator before proceeding. 
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10. Enter the following function definition to test target memory: 

? FUNC MEMTST(3,1) BEGIN 
1? LOC 1 = ARG 1 
1? WHILE LOC 1 LOE ARG 2 DO 
1? BEGIN 

2? @LOC 1 = ARG 3 
2? LOC 1 = LOC 1 + 2 

2? END 

1? LOC 1 = ARG 1 
1? WHILE LOC 1 LOE ARG 2 DO 
1? BEGIN 

2? IF @LOC 1 NE ARG 3 THEN RETURN LOC 1 
2? LOC 1 = LOC 1 + 2 

2? END 

1? RETURN -1 

1? END 

11. Enter the following function call to execute function MEMTST. The example shows 
the return that is displayed by a successful test. If a hexadecimal address is displayed 
instead of the -1, the test has failed, and maintenance should be performed on the 
emulator before continuing. 

? MEMTST(0,>1FFE, >10FF) 

-1 

12. Enter the following statement to set the program counter of the target system: 

? PC = 01(5® 

13. Enter the following command to start the emulator: 

? ERUN; 

14. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 

? ESTAT; 

EMULATOR IS EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

>0000 BREAKPOINTS COUNTED. 


15. If the emulator is not running, perform maintenance on the emulator before pro- 
ceeding. Otherwise, enter the following command: 

? EHLT ; 
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16 . 


Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 


? ESTAT; 

EMULATOR IS NOT EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

>00018 BREAKPOINTS COUNTED. 

0 ADDRESSES TRACED. 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with the emulator or buffer module which must be corrected before performing any further 
tests. 

The following error message is typical of the error messages that indicate a buffer module problem: 




*** ERROR 205 0700 0001 

EMULATOR DSR ERROR; 

02XX = ILLEGAL OPERATION, 

05XX = MEMORY WRITE ERROR, 

06XX = OPERATION TIMED OUT, 
07XX = DEVICE ERROR. 


For a more thorough test of the emulator and buffer, perform the procedure in paragraph 5.3 to 
execute the hardware demonstration test. The hardware demonstration test also tests the trace module 

as an option. 


3.2.2 TARGET SYSTEM ADDRESS AND DATA BUS CHECKOUT. When the target connector 
is plugged into a target system, faults on the address bus or data bus can cause improper butter 
module operation. To detect this type of fault, perform the following steps: 


Verify that power to the target system is off. and plug the target connector into the 
target system. If the value of EUM has been altered, repeat step 6 ot paragraph 3 — 1. 


2 . 

3. 


Apply power to the target system. 

Enter the following function call to execute function MEMTST (if the butter module 
checkout has not been performed since the AMPL program was loaded, perform 
steps 5 and 10 of paragraph 3.2.1 before performing this step): 

? MEMTST(0,>1FFE,>10FF) 

-1 


4. If the return from function MEMTST is not 1 as in the example, check the address 
bus and the data bus on the target system before proceeding. Otherwise, enter the 
following statement to set the program counter of the target system: 


? PC = 0100 
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5. Enter the following command to start the emulator: 


? ERUN; 

6. Call procedure ESTAT again. The following is an example of the call and the resulting 
display : 

? ESTAT' 

EMULATOR IS EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

>0000 BREAKPOINTS COUNTED. 

7. If the emulator is not running, perform checks on the target system before proceeding. 
Otherwise, enter the following command: 

? EHLT 

8. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 


? ESTAT; 

EMULATOR IS NOT EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

>0000 BREAKPOINTS COUNTED. 

0 ADDRESSES TRACED 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 

with the target system; a cross, short, ground, or other improper connection on the target system 

prevents proper operation of the emulator or proper memory access. Correct the problem before 
attempting any further tests. Error messages shown in paragraph 3.2.1 are typical. 

3.2.3 TARGET SYSTEM CLOCK CHECKOUT. After verifying that the emulator works 
properly when connected to the target system, perform the following steps: 

1. Set the CLOCK switch on the buffer module to the TARGET SYS position. 

2. Enter the E1NT command as in step 5 of paragraph 3.2. 1 to select the emulator. An EIN I 
command must be issued following each change of CLOCK switch setting. 

3. Enter the following function call to execute function MEMTST. The example shows 

the return that is displayed by a successful test. If a hexadecimal address is displayed 

instead of the -1, the test has failed, and the target system dock circuitry should be 

checked before continuing. 

? MEMTST (0, >1FFE,>10FF) 

-1 

4. Enter the following statement to set the program counter of the target system: 

? PC = 0100 
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5, Enter the following command to start the emulator: 


? ERUN; 

6. Call procedure ESTAT. The following is an example of the call and the resulting 
display: 

? ESTAT; 

EMULATOR IS EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

00©0 BREAKPOINTS COUNTED. 

7. If the emulator is not running, check the target system clock circuitry before con- 
tinuing. Otherwise, enter the following command: 

? EHLT ; 

8. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 

? ESTAT; 

EMULATOR IS NOT EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

>UU BREAKPOINTS COUNTED. 

® ADDRESSES TRACED 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with the target system clock. Correct the problem before attempting any further tests. Error 
messages shown in paragraph 3.2.1 are typical. 


3.2.4 TARGET SYSTEM MEMORY CHECKOUT. After verifying that the emulator works 
properly when connected to the target system and clocked by the target system clock, verify 
target system memory by performing the following steps: 

1 . Enter the following statement to map target system memory into addresses 0 through 
1 FFF 16 : 

? EMU = © 

2 . Enter a function call to execute function MEMTST. The arguments of the example shown 
assume that addresses 0 through 1FFF 16 are available as Random Access Memory (RAM) 
in the target system. The first argument should be the lowest address available and the 
second argument should be the highest address available within the range of 0 to FFFF 16 . 
The example shows the return that is displayed by a successful test. If a hexadecimal 
address is displayed instead of the - -1, the test has failed, and target system memory 
should be checked before continuing. 

? MEMTST(®,>1FFE ,>1®FF) 

-1 

3. Enter the following statement to set the program counter of the target system. The 
value shown is consistent with the arguments of the call to MEMTST in the preceding 
example. Use a value within the range of the first two arguments of the call to 
MEMTST. 

? PC = 01®© 
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4. Enter the following command to start the emulator: 

? ERUN ; 

5. Call procedure ESTAT. The following is an example of the call and the resulting 
display: 

? ESTAT; 

EMULATOR IS EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

. EVENT CONDITIONS ARE NOT SATISFIED. 

>UU BREAKPOINTS COUNTED. 

6. If the emulator is not running, check the target system memory before proceeding. 
Otherwise, enter the following command: 

? EHLT ; 

7. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 

? ESTAT' 

EMULATOR IS NOT EXECUTING. 

EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

0 BREAKPOINTS COUNTED. 

0 ADDRESSES TRACED 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with target system memory. Correct the problem before attempting any further tests of the 
target system. Error messages shown in paragraph 3.2.1 are typical. 

When the preceding tests of the target system have been performed successfully, the interface 
between the target system and the buffer module is working properly. Proceed with further tests 
of the target system. 

3.3 PROTOTYPING LABORATORY APPLICATION EXAMPLE 

A real-life example of prototyping laboratory application to development problems may help bring 
together many of the AMPL concepts in this book. This particular application uses only a very small 
part of the AMPL capability to rapidly solve a problem which resists analysis by conventional 
diagnostic program, oscilloscope, and logic analyzer techniques. 

The target system is a peripheral controller under development for use with the 990 family of 
computers. The controller uses a TMS 9900 microprocessor and a 2K ROM program to control 
data transfer to and from a bulk storage device. An onboard RAM provides a scratch pad for the 
TMS 9900 and a data buffer between the 990 computer and the storage device. This data buffer 
is managed as a “software FIFO” (first in, first out) buffer by the TMS 9900 microprocessor. 
The peripheral controller is installed in a 990 computer, and is exercised by a diagnostic program 
running in the 990 computer. 

An intermittent failure in data transfer and device control occurs as the diagnostic tests are 
performed. This intermittent failure occurs once in 30 or 40 minutes of continuous operation. 
The diagnostic test printouts indicate a data buffer underflow, which does not pinpoint the 
problem, even with a conventional logic analyzer. 
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The solution to the problem is complicated by the real-time operating environment required by 
the peripheral device. It is not possible to insert breakpoints into the controller program and still 
maintain control of the peripheral device. For the same reason, it is not possible to single-step 
through the controller program. 

The random nature of the failure indicates the possibility of a noise problem. An oscilloscope is used to 
trace noise sources and noise sources are suppressed. The result of this effort is a noise-tree board with 
an intermittent failure. The problem is solved by the AM PI. prototyping laboratory as described in the 
following paragraphs. 

The trace and emulator modules are connected together in the emulator control and data mode (figure 
5-1), and the target connector is plugged into the TMS 9900 socket on the peripheral controllei under 
test. 

The TDATA, TEDUMP, TSTAT, and ESTAT procedures are copied from the AM PE system 
diskette, using the procedures of Appendix H. The “canned” procedures and functions of Appendix H 
add significantly to ease of operation. 

The fault is accompanied by an indication of data buffer undertlow, so it seems reasonable to 
install a breakpoint when underflow occurs, and then to examine the events leading up to the 
underflow. 

Memory location 10D2 16 in the peripheral controller is used as a counter which keeps track of 
the number of words in the “software FIFO’ . During a w'rite operation to the bulk storage 
device, this counter should increment as data is loaded into the FIFO, and decrement as data is 
transferred out. Under normal control by the read/write program, the counter contents should 
never go negative. 

The emulator is set up to monitor and to give a compare each time an access is performed to 
FIFO counter address 10D2 16 , such as: 

? ECMP ( ADDR j >1(Z)D2 ) 


The trace module is set up to trace data written into that address as follows: 

? TTRC (DATA+EMU-DBIN , 256,EXT) 

This command traces data when the emulator compare is true (+FMU) and a write operation 
(-DB1N) is performed. The emulator compare was previously set to occur at address 101)2,,, . 

The TTRC command is verified by entering: 


?TTRC; 

The response is: 


+DATA- DBIN+EMU 
256 

+EXT 

+0FF 
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This verifies that the TTRC command was accepted and displays the current values of the 
optional arguments which were not modified by the TTRC command. In the preceding case, 
these are the default values. 

The select trace event command TEVT is checked by entering: 

?TEVT ; 

The response is: 

1 

0 

+NORM+EACH+INT 

These are the default parameters and are correct as is. They specify that 1 event will stop the 
trace, that there will be no delay, triggering will be on the true level, each equal comparison will 
be counted, and the internal trace module comparison will be used as the event. 

The trace module will be set to give a compare when all the trace conditions are met, and the 
FIFO counter goes negative. This command is entered as follows: 

?TCMP (DATA+EMU-DBIN ,0FFFF ,0FFFF) 

The first 3 conditions are the same as used in the TTRC command; that is, when the emulator 
compares (at address 1 0D2 16 ), and a write operation is performed. The second entry is the value 
FFFF 16 . The mask (third entry, OFFFF) examines the least significant 16 bits of the 20-bit 
trace word. If address 10D2 i 6 contains FFFF 16 , the FIFO counter has underflowed (gone 
negative). 

The breakpoints are set up with the EBRK and TBRK commands as follows: 

7EBRK (OFF, SELF) 

?TBRK (EVT,SELF) 

and the emulator and trace modules are started with: 

7TRUN; 

7ERUN ; 

Wait for a failure of the peripheral controller. Status of the trace can be checked periodically in 
the TST variable with the TSTAT procedure. The TSTAT procedure gives a plain language status 
printout, rather than a hexadecimal code, as shown below: 

7TSTAT ; 

TRACE MODULE IS NOT TRACING 
TRACE BUFFER IS FULL 
EVENT CONDITIONS ARE SATISFIED 
0001 BREAKPOINTS COUNTED 
256 SAMPLES IN BUFFER: -255 ... 0 
mi EVENTS COUNTED 
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This status printout indicates that the event occurred. A trace dump procedure (T DAT A) can be used 
to print all 256 data \alues in the trace butter, as shown in figure 3-5. 1 he INDEX column shows the 
index into the trace butler, with the oldest sample printed first. Three samples are printed in each row. 
The values of interest are the hexadecimal values printed in the LOW columns. Each ot these values 
represents a 16-bit E1EO counter \alue written into location !()D2|„. 

The E l EG counter is at 13,„ w hen sample -255 is taken. The counter increments to a maximum v alue ot 
50k, (sample -194) as the F1EO fills, and decrements to 0 (sample -114) as the FIFO empties. The 
pattern is shown in figure 3-6. An unexplained reset, from 31k, to 0 occurs at sample -1. and the 
underflow occurs on the next access. 


This test with the prototyping laboratory shows that the underflow ot the El TO counter is. in 
this case, apparently caused by a “phantom reset" ot the EIEO counter in the middle ot a data 
transfer. 

Now investigation centers on the possible causes of this “phantom reset”. Somehow, some 
instruction is writing a zero value into address 10D2 16 . It might be a CLR instruction, a MOV, 
or a number of other instructions. 

Reading the program listing shows several instructions capable ot clearing address 10D2, 6 . I hese 
instructions are part of the normal program, but it may be that a code containing a clear 
instruction is being executed out of sequence. 

Set up the emulator module to trace addresses and the trace module to trace data as follows: 

7ETRC (ADDR,256 ,EXT ) 

7TTRC ( DATA, 256 , EXT) 

Define the emulator event as the internal compare, and the emulator breakpoint as the emulator 
event, as follows: 

7EEVT (INT) 

7EBRK (EVT .SELF) 

Set up the emulator compare to occur when the suspected instruction is executed. This is done 
with an ECMP command: 

7ECMP ( IAQ,>hex address of suspected instruction) 

Start the trace with the TRUN and ERUN commands, and wait for the failure to occur. If the 
failure occurs, but the emulator compare does not, the suspect instruction did not cause the 
failure. If the emulator compare does occur and the failure does not. the instruction has 
executed without causing the failure. The trace is repeated until the failure occurs, and it no 
compare accompanies the failure, a new instruction is selected for examination. 

If the failure is accompanied by a compare, the trace and emulator butters are dumped via a 
TEDUMP procedure. The TEDUMP procedure prints out the emulator trace indexes, the address, 
the corresponding trace buffer index and the instruction, as shown in figure 3-7. 
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Figure 3-5. TDATA Printout for Prototyping Lab Example (Sheet 1 of 2) 
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Figure 3-5. TDATA Printout for Prototyping Lab Example (Sheet 2 of 2) 


The 256 sample trace has been shortened in the f igure. The emulator compare occurs at emulator index 
-3 Prior history is checked bv reading up the printout from index 0 toward -256. At -38, a level 7 
interrupt (address OOICk,) is reported. However, the peripheral controller is not supposed to have an 
interrupt on level 7. The lowest priority interrupt should be a 4 millisecond timer at level 4. The 
interrupt priority assignments are at fault in this case. The valid level 4 interrupt is not being serviced in 
time. It is causing an interrupt request, but by the time the priority encoder is tested, the valid interrupt 
has disappeared, leaving a default hexadecimal 7 on the priority encoder output. The code associated 
with level 7 interrupts is causing a FIFO underflow indication, and masking the real problem, 
occasional failure to service the timing interrupt. 

A reassignment of interrupt priorities assures that the timing interrupt could not be masked lor an 
excessive length of time, and completely cures the problem. 
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Figure 3-6. Observed FIFO Counter Operation 
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>C4 06 

D. 

-36 

> 1 OBC 

164 

> 0 366 

. F 

-35 

>10BA 

165 

> 1 0 0 0 

. . 

-34 

>00 IE 

166 

> 0 1 C A 

. J 

-33 

>01 CA 

167 

> OE' 05 

. . 

-32 

>01CC 

168 

> 0 047 

- b 

-31 

>10AA 

169 

> 0 04 7 

. b 

-30 

>01CE 

170 

> 046 0 


-29 

>01 DO 

171 

> 0 1 5C 


-28 

>01 5C 

172 

> 06C5 

. E 

-27 

>01 5C 

173 

> 06C5 

. E 

-26 

>10AA 

174 

> 0 047 

. b 

-25 

>10AA 

175 

> 4 7 0 0 

b . 

-24 

>01 5E 

176 

: D805 

! •* . 

-23 

> 1 OAA 

177 

>4700 

b . 

-22 

>0160 

178 

> 1 OE 3 

. C 

-21 

>10E2 

179 

> 080 0 


-20 

>10E2 

180 

> 0847 

. b 

-19 

(A ) 1 365 36 (1/2) 

>0162 

181 

58E 0 



INTERPRETATION 
WRITE >0555 
TB >0005 

READ >OOAO 
JNE *+>0013 
LDCR R5,4 

READ >0555 


READ >0BB2 
READ >0380 

RTWP 

READ >C406 
READ >0366 
READ >1000 
READ > 1 OAO 
WRITE >C406 
WRITE >0366 
WRITE >1000 
READ >01 CA 
LI R5» >0000 

READ >0047 
WRITE >0047 
B ®>0000 

READ >01 5C 
READ >06C5 
SWPB R5 

READ >0047 
WRITE >4700 
MOVB R5,®>0000 
READ >4700 
READ > 1 0E3 
READ >0800 
WRITE >0347 

szcb e>oooo,e>oooo 


Figure 3-7. TEDUMP Printout for AMPL Example (Sheet 1 of 2) 
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-18 

>0164 

-17 

>0028 

-16 

>0166 

-15 

>10E2 

-14 

>10E2 

-13 

>0168 

-12 

>01 6A 

-11 

>002E 

-10 

>01 6C 

-9 

>10E2 

-8 

>10E2 

-7 

>01 6E 

-6 

>0170 

-5 

>10E0 

-4 

>10E0 

-3 

*ECMP >0172 

-2 

>0174 

-1 

>10D2 

0 

>10D2 


182 

> 0 0£*9 

- ' 

183 

>5 Ode; 

p" 

184 

> 1 OEE 

. E 

185 

> 0847 

. b 

186 

> 0847 

■ b 

187 

> F 88 0 


188 

> 0 08 E 


189 

> D 0 0 0 

p. 

190 

> 1 OEE 

. E 

191 

>0847 

. b 

192 

: D847 

XG 

193 

> 04E 0 


194 

> 1 OE 0 

. S' 

195 

> 7 0 0 0 

p. 

196 

> U (J u u 

, , 

197 

> 04E 0 


198 

> 1 ODE' 

. R 

199 

> 0 03 1 

. 1 

200 

> 0 0 0 



READ >0029 . ) 

READ >5022 P“ 
READ >10E2 .B 
READ >0847 . G 

WRITE >0847 . G 

socb e>oooo,e>oooo 

READ >002E . . 

READ >DOOO P. 
READ >10E2 .B 
READ >0847 . G 

WRITE >D847 XG 
CLR «>0000 

READ >10E0 
READ >7000 P. 
WRITE >0000 . . 

CLR S>0000 

READ >10D2 .R 
READ >0031 . 1 

WRITE >0000 .. 


'All 36536 (2/2) 


Figure 3-7. TEDUMP Printout for AMPL Example (Sheet 2 of 2) 


3.4 TRACE PROBE EXAMPLE 

The trace module may be used independently of the emulator for general tracing operations. For 
example, a tape cassette controller is experiencing data readback failures during diagnostic-testing. 
The diagnostic shows that a hexadecimal “05” is being read back occasionally from a record of all 
“04” characters. The problem appears to be in the data, rather than in the operation of the periph- 
eral controller program. 

Figure 3-8 is a simplified diagram of the controller “front end”. If the error is present at the FIFO 
output, the error must be ahead of (or in) the FIFO. This would eliminate the program and all the 
logic downstream from the FIFO. 


To determine if the error is present at the FIFO output, attach a DIP test adapter onto the 3341 
FIFO device and attach the trace probe leads to the adapter pins corresponding to FIFOl, 2, 3, 
and 4. Any 4 of the 20 trace data leads could be used but they should represent one hex character, 
with LSB to MSB order preserved. For this example, the four least significant leads, D16-D19, 
are used. The CLOCK lead is attached to the shift out clock pin. The GND lead is connected to 
logic ground. 

The other end of the trace probe cable is connected to the trace module, replacing the emulator/ 
trace data cable. 


The emulator will only be used to supply a TMS9900 microprocessor to the target system. 
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Set up the trace as follows: 

7TTRC (0FF,126,+EXT,+0FF) 

The qualifiers, Q0-Q3. are not required, 126 samples are to be stored, and the rising e-dge of the 
external (FIFO shift out) dock is used. The latch mode is disabled. 

Set up a comparison to provide a breakpoint when the error occurs, as follows: 

? TCMP(0FF,5,0F) 

Specify 1 test event, and delay of 128 as follows: 

?TEVT (1,128) 

This puts the event in the middle of the 256-word trace buffer, so data on either side of the 
event may be examined. 

The trace breakpoint is defined as: 

7TBRK (EVT,EMU) 

and the trace is initiated by: 

7TRUN; 

7ERUN; 

After the target system read operation is started, the status is checked and the trace module trace buffer 
is printed out by TDATA. The printout, figure 3-9, shows that the faulty data is appearing at the FIFO 
output, so the fault is ahead of this point. The program and about 90% of the logic have been 
exonerated by this quick test, which takes longer to describe than to perform. 


3.5 TMS 9980 EXAMPLES 

The application examples are for target systems that use the TMS 9900 microprocessor. They may be 
used on a target system that uses a TMS 9980 microprocessor, but the addresses and data stored in the 
memories of the emulator are different. To understand the difference, consider the difference in the 
microprocessors. 

The most significant difference between the microprocessors is that the TMS 9900 has a 16-bit data 
bus, and accesses a word of memory at each memory access, and the TMS 9980 has an 8-bit data bus 
and accesses a byte of memory at each memory access. The TMS 9980 performs two memory accesses 
for each word required. In the emulator (in which memory addresses are traced) a trace operation 
stores the addresses of each byte stored. When the trace module is tracing data supplied by the 
emulator, the data is supplied on a 16-bit bus. During a memory access of an even address, the most 
significant byte of the bus contains the data being transferred to or from memory, and the least 
significant byte contains random data. During a memory access of an odd address, the least significant 
byte of the bus contains the data being transferred to or from memory, and the most significant byte 
retains its previous contents. Thus the entire word as it is stored in memory is present on the 16-bit data 
bus during a memory access to an odd address. 
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T CMP ( OFF , 5, OF) 
? TRiJN 
? ERUN 


? TSTAT 

TRACE MODULE IS NOT TRACING. 
TRACE BUFFER IS FULL. 

EVENT CONDITIONS ARE SATISFIED. 
>0000 BREAKPOINTS COUNTED. 


256 SAMPLES IN BUFFER: 
>0001 EVENTS COUNTED. 

? TDATAITTBO, TTBN) 


•127 


INDEX 

HIGH 

LOW 

HIGH 

LOW 


HIGH 

LOW 


--127 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


-124 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


--121 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


-118 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


-115 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


-112 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


- 1 09 

/ >0000 

>0004 

>oooo 

>0000 


>0000 

>0000 


- 1 06 

/ >0000 

>000E 

>0000 

>000A 


>0000 

>000A 


- 1 03 

/ >0000 

>oooc 

>0000 

>0000 


>0000 

>0000 


- 1 00 

/ >0000 

>0003 

>0000 

>0000 


>0000 

>oooc 


-97 

/ >0000 

>000 A 

>0000 

>000A 


>0000 

>0008 


-94 

/ >0000 

>0004 

>0000 

>0004 


>oooo 

>0004 


-91 

T 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 

T 


X . 

“l -“l 

/ X )( It )( ) 

>0004 

>0000 

>0004 


>0000 

1 

>0004 


-19 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


-16 

/ >QOOO 

>0004 

>0000 

>0004 


>0000 

>0004 


-13 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


-10 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0000 


-7 

/ >0000 

>0000 

>0000 

>000E 


>0000 

>000A 


-4 

/ >0000 

>000A 

>0000 

>000C 


>0000 

>0000 


-1 

/ >0000 

>0000 

>0000 

>0005 


>0000 

>0000 


jtL 

/ >0000 

>000C 

>0000 

>OOOA 


>0000 

>OOOA 


5 

/ >0000 

>0008 

>0000 

>0004 


>0000 

>0004 


8 

/ >0000 

>0004 

>0000 

>0004 


>oooo 

>0004 


1 1 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


14 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


17 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 


20 

/ >0o0u 

>0004 

>0000 

>0004 


>0000 

>0004 


23 

T 

/ >0000 

>0004 

>0000 

>0004 


>0000 

>0004 

T 


1 

1 16 

/ >0000 

>0004 

>0000 

>0004 


>0000 

1 

>0004 


1 19 

/ >0000 

>0004 

>0000 

>0004 

« ■ 

>0000 

>0004 

■ at 

122 

/ >0000 

>0004 

>0000 

>0004 

- • 

>0000 

>0004 

„ „ 

125 

128 

/ >0000 
/ >0000 

>0004 

>0004 

>0000 

>0004 

• - 

>0000 

>0004 

- " 


(A) 1 36538 


Figure 3-9. Trace Probe Example 
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When the examples as stated for the TMS 9900 microprocessor are executed in the TMS 9980 
microprocessor, the emulator trace memory contains redundant addresses and the trace module 
memory contains meaningful information in alternate words. Qualifier Q0 of the trace module is 
connected to the least significant address bit, true on even memory addresses. By using qualifier 
DATA-QO in the TTRC commands, the trace module memory stores only alternate words, when the 
data stored consists of valid memory words. This data corresponds to the data traced in the TMS 9900 
operation. By specifying EXT in the ETRC command, the clock for tracing in the emulator is enabled 
by the trace module clock (qualified by Q0), and odd addresses are traced. Thus the capabilities of the 
AMPL Microprocessor Prototyping Laboratory are as effective in developing TMS 9980 systems, but 
the commands are somewhat different. Details of the differences in the commands are described in 
Section V. 
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SECTION IV 

AMPL MICROPROCESSOR PROTOTYPING LANGUAGE 


4.1 INTRODUCTION 

Statements entered by the user to control the emulator, trace module, and target system are 
written in the AMPL Microprocessor Prototyping Language. AMPL elements are used as operands 
of the user commands described in Section V. 

Statements entered at the operator console are checked for syntax and translated into an 
intermediate code. The intermediate code is processed by the AMPL Interpreter, which performs 
the operation specified by the statement. 

4.2 LANGUAGE ELEMENTS 

The characters of the AMPL character set are combined to form the following language 
elements: 

• Constants 

• Symbols 

4.2.1 CHARACTER SET. The set of ASCII characters recognized by AMPL consists of the 26 
letters (A-Z), the ten numerals (0-9), and the following special characters: space, ”, (, ), *, /, +, 

9 ••••<>' @ # 


NOTE 

AMPL accepts only upper case characters. If a 9 1 1 VDT is being used 
as the console, push the key labeled UPPER CASE LOCK. This key 
is in the upper left corner of the keyboard. 


These special characters are used as follows: 

space To separate keywords and symbols 

To enclose character constants 
To enclose character strings 

( ) To enclose argument lists and subexpressions 

*/+- To indicate arithmetic operations 

= To assign a value to a variable 

To identify load module symbols 
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To separate elements in argument lists 

To identify the following characters as a comment 

? To request user input, and to specify a display and modify operation 

To concatenate a format specification to an expression to be displayed 

: : To separate the expression from the statement in a CASE statement 

; To terminate a display and modify operation, and (optionally) to separate 

statements within a procedure, function, or compound statement 

< To identify the following digits as a binary constant 

> To identify the following digits as a hexadecimal constant 

! To identify the following digits as an octal constant 

@ To indicate an indirect target memory access 

# To enclose single source code lines for assembly 

4.2.2 CONSTANTS. The user may specify a constant in any of the following formats: 

• Decimal 

• Hexadecimal 

• Octal 

• Binary 

• Character 

• Instruction 

The expressions required in AMPL statements may include one or more constants, alone or 
combined with other elements by means of arithmetic or logical operators. 

4.2.2. 1 Decimal Integer Constants. A decimal integer constant is entered as a string of decimal 
digits (0 through 9), the first of which may not be 0. The range of values of decimal integers is 1 
through 32767. The following are valid decimal constants: 



Constant 

Value 


1000 

1000 or 3E8 t 6 


23 

23 or 1 7 16 

The following is an 

invalid decimal constant: 


0250 


First digit is zero. 
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4.2. 2.2 Hexadecimal Integer Constants. A hexadecimal integer constant is entered as a string of 
hexadecimal digits (0 - 9. A - F). Either the first digit must be zero or the string must be 
preceded by a greater-than character (>). The range of values of hexadecimal integers is 0 
through FFFF 16 . The following are valid hexadecimal constants: 


Constant 

Value 

OF 

F 16 or 15 

0250 

250 16 or 592 

0 

0 

>100 

100, 6 or 256 

>28 

28,6 or 40 

>F3 

F3 , 6 or 243 

4. 2. 2. 3 Octal Integer Constants. An octal integer constant is entered as a string of octal digits 
(0 - 7) preceded by an exclamation point (!). The range of values of octal integers is zero through 
177777 8 . The following are valid octal constants: 

Constant 

Value 

! 1 73 

1 73 g or 7B, 6 or 123 

12620 

2620 8 or 590, 6 or 1424 

114 

14 8 or C, 6 or 12 

4. 2.2.4 Binary Integer Constants. A binary integer constant is entered as a string of binary digits 
(0 or 1) preceded by a less-than character (<). The range of values of binary integers is 0 through 
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 ■ The following are valid binary constants: 

Constant 

Value 

<101101 

101101 2 or 2D, 6 or 45 

<100 

100 2 or 4 

<010011010010 

1001 1010010 2 or 4D2, 6 or 1234 
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4.2.2. 5 Character Constants. A character constant is entered as a string of one or two characters 
enclosed in quotation marks. The characters are represented internally as eight-bit AS( II 
characters with the leading bit set to zero. When a character constant consists of one character, 
the character is right-justified and leading zeros are placed in the internal representation. Ihe 
following are valid character constants: 


Constant 

Value 

“AB” 

4142) 6 

“C” 

0043 16 


232F 16 


4.2. 2.6 Instruction Constants. An instruction constant is entered as a source code instruction 
line enclosed in pound signs (#). The source code line consists only of an operation field and an 
operand field. No label field is entered, and comments are not entered within the pound signs. 
(Comments may be entered as in any AMPL statement as described in paragraph 4.2.6. ) Only 
instruction operation codes and pseudo-instruction operation codes RT and NOP may be used. 
Workspace registers must be specified as R0 through R15, and the operand field of jump 
instructions must be program-counter relative; i.e., $+4, $-2, etc. 

The operand field of an instruction constant may not contain a label or a user symbol. It may contain a 
load module symbol. A load module symbol (paragraph 4.2. 3. 3) is a symbol in a program that has been 
loaded into target system memory. 

An instruction constant may be used in an assign statement (paragraph 4.6.2) or in the display and 
modify mode (paragraph 4. 6. 3. 5). In the first case, the internal form of an instruction constant is a 16- 
bit word containing the machine instruction (or the first word of the machine instruction) derived lrom 
the source code instruction. Two- and three-word instructions require that the literal value or address 
or addresses be entered as integer constants or variables, even though the value or address has been 
specified in the source code. The AMPL single line assembler requires the operands to correctly 
assemble the addressing modes in the first instruction word, but does not assemble second and third 
words of instructions. 

When an instruction constant is used in the display and modify mode the complete instruction (one, 
two or three 16-bit words) is assembled and placed in target system memory. Examples of use of 
instruction constants in this mode are shown in paragraph 4. 6. 3. 5. 

The following are examples of instruction constants used other than in the display and modify mode: 

#M0V *R0+,*R1# A move instruction that moves the word at the ad- 

dress in workspace register 0 to the address in work- 
space register 1 , and increments workspace register 0 
by two. The value of the constant is C470 16 . 
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#LI R0, >FFFF# A load immediate instruction that places a value in 

workspace register 0. The value of the instruction 
constant is 0200, 6 . The value to be placed in work- 
space register 0 is the contents of the word that 
follows the instruction constant. 

#mov A move instruction that moves the word at location 

1 00j 6 to location 300i 6 indexed by workspace 
register Rl. The value of the instruction constant is 
C860! 6 . The actual addresses for the instruction are 
the contents of the two words that follow the ad- 
dress constant. 

#JMP $-4# A jump instruction. The value of the instruction 

constant is 10FD, 6 . 

The following are examples of invalid instruction constants: 

#JMP 0104# Invalid. Jump instructions may not specify addresses. 

#L00P MOV *R$+,*R1 Invalid. The label field may not be used. 

#DEF BUFF,MSG1# Invalid. Assembler directives may not be used. 

4.2.3 SYMBOLS. The symbols used in AMPL may be of any of the following types: 

• User symbols 

• System symbols 

• Load module symbols 

The expressions required in AMPL statements may include one or more symbols, alone or 
combined with other elements by means of arithmetic or logical operators. 

4.2.3. 1 User Symbols. A user symbol is a string of alphanumeric characters, the first of which 
must be alphabetic. If more than six characters are entered, the first six characters are stored 
internally as the symbol and the remaining characters are ignored. The software prints a warning 
message. The user defines a symbol to represent a location within a program, a mask, a counter, 
a constant, a variable, a switch, or a flag. The following are valid user symbols: 

LBL1 

ST0PHERE Internal representation of this symbol 

consists of STOPHE (first six characters). 

The following are not valid user symbols for the reasons indicated: 

1L0C Begins with a numeral. 

A 1 BC Contains a special character. 

User symbols are global symbols; i.e., they continue to apply until the symbol table is cleared. 
User symbols must be unique with respect to each other and with respect to system symbols and 
reserved words (Appendixes D and E). 
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4.2. 3. 2 System Symbols. A system symbol is a string of up to four alphanumeric characters that 
is predefined in AMPL software. System symbols are assigned to the following: 


• Workspace registers and PC, WP and ST of the target system 

• Tmulator bits 

• Trace module constants 

• System values and masks 

• Names of user commands 

• Keywords used as operands of user commands. 


The user may not delete system symbols, nor add symbols to the set of system symbols. The 
user may alter the values of some system symbols. The system symbols, which are reserved 
words, are listed in Appendix E. Use of specific system symbols is described with the AMPL 
statements and user commands to which the symbols apply. 

4. 2. 3. 3 Load Module Symbols. Symbols from a source program may be defined when the object 
module is loaded, and may be used in AMPL statements. Optionally, the following types of 
source code symbols may be defined: 

• The module identifier (operand of the IDT directive) 

• External definitions (operands of DEL directives) 

• Unresolved external references (operands of REF directives). 

These load module symbols may be used until symbols from another module are loaded, or until 
the symbol table is cleared by command. The assembly language allows up to eight characters for 
the module identifier: the AMPL loader truncates the identifier to the first six characters. When 
using a module identifier in an AMPL statement, enter a period following the identifier as 
follows: 

MYPROG. 

SINTST. 

When using either an external definition or an unresolved external reference in an AMPL 
statement, precede the definition or reference with a period, as follows: 

.START 

.INBUFF 

4.2.4 ARRAYS. The AMPL language supports one- and two-dimensional arrays (paragraph 4.6.1 ) 
consisting of groups of elements that are referenced by the array name and one or two expressions 
in parentheses. Each element of an array may be assigned a value and may be used as a variable in 
an AMPL expression. A one-dimensioned array is a group ot elements arranged in a row or list 
and specified by their position in the row. A two-dimensioned array is a group ot elements 
arranged in rows and columns and specified by a row and column position. The following are 
valid references to elements of arrays: 
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NUM(4) 
VAL(I) 
TABLE(4,6) 
INPUT( A,B) 


The fourth element of array NUM. 

An element of array VAL specified by the value of variable 1. 

The element of array TABLE in row 4 of column 6. 

The element of array INPUT in the row specified by the value of A 
of the column specified by the value of B. 


4.2.5 CHARACTER STRINGS. A character string is written as a string of up to 64 characters 
enclosed in single quotes. When a single quote is required as a character of the character string, 
two consecutive single quotes are entered to specify the single quote. The characters are 
represented internally as eight-bit ASCII characters with the leading bit set to zero. When a 
character string is entered as a statement, it is displayed as a message or comment. This is 
particularly useful when statements are written on a file to be entered with a COPY command 
(paragraph 5.7.14). The following are valid character strings. 

'MAIN' 


‘ INFILE 1 

1 : OUTFI L/OB J 1 

4.2.6 COMMENTS. A comment may either be added following an AMPL statement or entered 
as a separate AMPL statement. In either case, two consecutive periods introduce the comment, 
and a carriage return terminates the comment. The following are examples of valid comments: 

TEST PROGRAM LOOP 1 

ECMP (IAQ, SET BREAKPOINT FOR INSTRUCTION ACQUISITION AT ADDRESS >100 


4.3 NOTATION 

The notational conventions used in the syntax definitions in the manual are as follows: 

• Words shown in capital letters are reserved words (keywords). Reserved words and 
special characters must be entered as shown. 

• Words enclosed in angle brackets represent constants, symbols, expressions, or charac- 
ter strings supplied by the user. 

• Items enclosed in brackets ([] ) are optional. 

• Alternative items are enclosed in braces ( | | ). One must be chosen. 

• The ellipsis (. . .) indicates that the preceding item may be repeated. 

• A slashed lower case b (b) represents a required space character. 

In the examples, the b has the same meaning as in syntax definitions. Responses by AMPL 
software are underlined. 

4.4 FORMAT 

AMPL software prints a question mark as a prompting character whenever it is ready to receive 
an AMPL statement or command: 
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In statements and commands, each reserved word, constant, or symbol must be followed by one 
or more spaces to separate these AMPL elements. In this document, carriage return means the 
operation associated with keys marked RETURN or NEW LINE on various devices. The user 
must enter a carriage return to terminate each line. 

When a statement requires more than one line, either because ot the length ot the statement or 
to show the statement structure more clearly, a compound statement must be used. 


4.5 EXPRESSIONS 


An expression consists of a constant, a symbol, a subexpression, an array element, or a series of 
constants, symbols, subexpressions and/or array elements separated by arithmetic, logical, or 
relational operators. Each constant, symbol, subexpression or array element may be preceded by 
any of the unary operators. 

4.5.1 SUBEXPRESSIONS. A subexpression is an expression enclosed in parentheses. A 
subexpression is evaluated before evaluating the expression that contains the subexpression. 
Subexpressions may contain other subexpressions; the innermost subexpression is evaluated first. 

4.5.2 ARITHMETIC OPERATORS. 

metic. The operators are: 

Operator 

The arithmetic operators of AMPL perform integer arith- 

Operation 

+ 

Addition 

- 

Subtraction 

* 

Multiplication 

/ 

Division 

MOD 

Remainder 

The following are expressions using arithmetic operators: 

2 * (START + 4) 

The product of 2 times the sum of START plus 4 

LCN1/2 

The quotient of LCN 1 divided by 2 

LCNl)4MODj62 

The remainder obtained by dividing LCN 1 by 2 

TABEND-TABST 

The difference of TABEND minus TABST 

4.5.3 LOGICAL OPERATORS. The 

following logical operators are used in AMPL expressions 

Operator 

Operation 

AND 

Logical product 

OR 

Logical sum 


The following are examples of expressions using logical operators: 

CHARI Ntf AN DAMASK 

LCHARI40RHRCHAR 
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4.5.4 RELATIONAL OPERATORS. The following relational operators are used in AMPL 
expressions: 


Operator 

Relation 

EQ 

Equal to 

NE 

Not equal to 

LT 

Arithmetic less than 

LE 

Arithmetic less than or equal to 

GT 

Arithmetic greater than 

GE 

Arithmetic greater than or equal to 

HI 

Logical higher than 

HIE 

Logical higher than or equal to 

LO 

Logical lower than 

LOE 

Logical lower than or equal to 


The following are examples of expressions using relational operators: 

DAY0GE0340 
HOURJ6LTjai2 
C0UNT1J6H I EJ6COUNT2 

4.5.5 UNARY OPERATORS. The following unary operators are used in AMPL expressions: 

Operator Operation 

+ Plus 

Negation 

NOT One’s complement 

(a ! Indirect 

More than one unary operator may be used with a symbol, constant, or subexpression, and the 
operators may appear in any order. The operations are described in the following paragraphs. 

4.5.5. 1 Plus. The unary operator + performs no operation on the constant, symbol, or sub- 
expression to which it applies. It is included to provide uniformity. 
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4. 5. 5. 2 Negation. The unary operator specifies negation ol the value ot the symbol, constant, 
or subexpression to which it applies. The negation is equivalent to the result ot subtracting the 
value from zero. The following are examples of negation: 


-248 The result is -248. 

->FE The result is FF02 16 (two's complement) of -FE 16 , -254. 

4. 5. 5. 3 One’s Complement. The unary operator NOT specifies the one’s complement ot the 
value of the symbol, constant, or subexpression. The one’s complement ts equivalent to substi- 
tuting zeros for ones and ones for zeros in the binary representation of the value. The following 
are examples of one’s complements: 

N0T)6>F1F$ The result is 0E0F] 6 . 

NOT0FIVE Assuming symbol FIVE has been assigned the value 5, the 

result is FFFA, 6 . 

4. 5. 5.4 Indirect. The unary operator ("s accesses a location in target system memory using the 
value of the symbol, constant, or subexpression as an address. The C a J operator specifies “the 
contents of’. The following are examples of indirects: 

@>100 The result is the value in location 100 J6 of target mem- 

ory. 

0START The result is the value in a location in target system mem- 

ory. The value assigned to user symbol START is the 
target system memory address. 

@@WRKSPC The result is the contents of the contents of a location in 

target system memory. Assuming that WRKSPC has been 
assigned the value of the workspace address, the result is 
the contents of the location at the address in workspace 
register 0. 

Indirect Addressing Example. Assuming that LCN1 has been assigned the value 0106 16 , and that 
target system memory contains the following values: 


Target System Memory Address Contents 

(Hexadecimal) (Hexadecimal) 

0106 010C 

0108 0001 

01 0A 0002 

010C 0003 

010E 0004 


The values of the following expressions are: 

@LCNI 010C 16 

@@LCN1 0003 16 

@(LCNl+4) 0002 16 
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Target System Memory Addressing. The emulator contains a 256-word trace memory and a 
4K-word user memory. These memories are accessible at addresses in the target memory address 
space under control of logic in the emulator. Figure 4-1 illustrates the mapping of the address 
space to emulator or target system memory. System variable ETM maps addresses FE00 16 
through FFFFi 6 into emulator trace memory when it is set to one, and into target system 
memory when it is set to zero. System variable EUM maps addresses 0000i 6 through 1FFF, 6 
into emulator user memory when it is set to one, and into target system memory when it is set 
to zero. References to target memory in this document may be either target memory or 
emulator memory depending on the address and the current values of system variables EUM and 
ETM. 

4.5.6 EXPRESSION EVALUATION. Table 4-1 shows the hierarchy of the operators used in 
AMPL expressions. In evaluating an expression, level 7 operations are performed first, followed 
by operations at successively lower levels until the entire expression has been evaluated. 
Operations at the same level are performed in left to right order. 

The following is an example of an expression: 

42 + 5 * 8 / 4 

The hierarchical levels of the operations are 5, 6, and 6, from left to right. The leftmost level 6 
operation, 5*8, is evaluted first, and the result is 40. The other level 6 operation becomes 
40 / 4, or 10. The expression is now 42 + 10, or 52. Had the expression been: 

(42 + 5) * 8 / 4 

the subexpression (42 + 5) or 47 would have been evaluated first. The multiplication would be 
next, 47 * 8, or 376. The division would be last, 376 / 4, or 94. 


TARGET MEMORY 
ADDRESS 
(HEXADECIMAL) 


MAPS INTO 



TARGET MEMORY 
(EUM = O) 


EMULATOR USER MEMORY 
(EUM = 1 ) 


TARGET MEMORY 


TARGET MEMORY 
(ETM = O) 


EMULATOR TRACE MEMORY 
(ETM = 1 ) 


(A)1 36539 NOTE: 


IN THE TARGET MEMORY ADDRESS COLUMN, TMS 9900 ADDRESSES ARE SHOWN. 
ADDRESSES FOR THE TMS 9980 ARE SHOWN I N PARENTHESES WHERE TMS 9980 
ADDRESSES DIFFER. 


Figure 4-1. Target Memory Address Mapping 
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Table 4-1 . Hierarchy of Operations in Expressions 


Hierarchical Priority 

Operator 

Description 

7 

(a 

Indirect 

7 

+ 

Unary plus 

7 

- 

Unary minus (negation) 

6 

* 

Multiplication 

6 

1 

Division 

5 

- 

Subtraction 

5 

+ 

Addition 

4 

LT 

Arithmetic less than 

4 

LE 

Arithmetic less than or equal 

4 

EQ 

Equal 

4 

NE 

Not equal 

4 

GE 

Arithmetic greater than or equal 

4 

GT 

Arithmetic greater than 

4 

HI 

Logical high 

4 

LO 

Logical low 

4 

HIE 

Logical high or equal 

4 

LOE 

Logical low or equal 

3 

NOT 

One’s complement 

2 

AND 

Logical product 

2 

OR 

Logical sum 


In evaluating an expression, the carry that can occur during a + or - operation is stored in system 
variable MDR. The carry occurs when there is a carry out of the sign bit position ot the 16-bit 
result of the operation. MDR is set to 0 during either operation when no carry occurs, and to 1 
when a carry occurs. To use the carry (as in double-precision arithmetic, for example) the user 
must test the contents of MDR following each + or - operation, because the current contents ot 
MDR is the state of the carry bit resulting from the most recent operation. 


4.6 STATEMENTS 

The AMPL language supports the following statements: 

• ARRAY statements 

• Assign statements 

• Display statements 

• IF statements 

• CASE statements 
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• WHILE statements 

• REPEAT statements 

• FOR statements 

• Compound statements 

• ESCAPE statements 

• NULL statements 

4.6.1 ARRAY STATEMENTS. An ARRAY statement declares one or more arrays. The syntax 
for an ARRAY statement is as follows: 

7ARRAY0<array name>(<expr>[,<expr>] ) [,<array name>(<expr> [,<expr>] )] ... 

An array name is a user symbol that is to be the name of an array. It is followed by one or two 
expressions within parentheses. One expression is entered for a one-dimensioned array. The value 
of the expression is the number of elements in the array. Two expressions separated by a comma 
are entered for a two-dimensioned array. The value of the first expression is the number of rows 
of elements in the array. The value of the second element is the number of columns of elements 
in the array. Several arrays may be declared in an ARRAY statement. The length of the line is 
the limit of the number of arrays that may be defined in one statement. 

An array must be declared in an ARRAY statement before any element of the array may be 
referenced. Declaring an array causes the AMPL software to reserve space for the array and 
assigns the value of zero to every element in the array. Once declared, an array is global, 
applying to all programs being tested, until the symbol table is cleared. The space assigned to an 
array may be made available for other purposes by deleting the array, but the array name may 
only be used as the name of an array of the same number of dimensions until the symbol table 
is cleared. Following deletion, a one-dimensioned array may be declared again with a different 
number of elements, or a two-dimensioned array may be declared again with different numbers 
of rows and columns. 

The following are examples of ARRAY statements: 

? ARRAY NUM (7) Declares array NUM consisting of 

seven elements. 

? ARRAY TABLE (5,10) Declares array TABLE consisting of 

50 elements arranged in five rows and 
ten columns. 

? ARRAY VAL(8) , INPUT (6, COLS) Declares array VAL consisting of eight 

elements, and array INPUT consisting 
of 6 rows. The value of variable COLS 
is the number of columns in array 
INPUT. 
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4.6.2 ASSIGN STATEMENTS. An assign statement assigns a value to a user variable or a system 
variable. The syntax for this type of assign statement is as follows: 


2<symbol >=<express i on> 

The interpreter evaluates the expression and assigns the value to the symbol, a user symbol or a 
system symbol. An assign statement defines a user symbol when it assigns a value to a user 
symbol that has not been previously defined. An assign statement that assigns a value to a user 
symbol that has been defined alters the value of the symbol. In either ease, the value of the 
expression is assigned to the symbol. The following are examples of this type of assign 

statement: 


? LCN = >104 


Assigns the value 104 16 to user sym- 
bol LCN. If LCN is not defined, also 
defines LCN as a user symbol. 


? PC = LCN + 4 Assigns the sum of the value of LCN 

“ plus 4 to system variable PC (target 

system program counter). 

Another form of the assign statement assigns a value to a target system memory location. The 
syntax for this form of the assign statement is as follows: 


_? @<symbo1>=<expression> 

The (“ sign identifies the value of the symbol as an indirect address. The symbol may be a user 
symbol or a system symbol, and may be preceded by any ot the unary operators. The following 
are examples of this type of assign statement: 

? @LCN = 23 Assigns the value 23 to the target 

system memory location specified in 
LCN. 


? @WP = 548 Assigns the value 548 to the target 

™ system memory location contained in 

WP. This location is workspace regis- 
ter 0. 


A constant may be used to specify the target system memory address to which a value is 
assigned. The syntax for this type of assign statement is as follows: 

]_ @<constant>=<expression> 

The (" sign identifies the constant as an indirect address. The following are examples of this form 
of assign statement: 

? @$100 = #INC R$# Assign the value corresponding to the 

“ increment workspace register 0 in- 

struction to target system memory lo- 
cation 100 16 . 

? @>EF$$ = 256 Assigns the value 256 to target system 

memory location El 00! 6 . 
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An expression within parentheses may be used to specify a target system memory address to 
which a value is assigned. The syntax for this type of assign statement is as follows: 


? @(<expr 1>)=<expr2> 

The (? sign identifies the value of the expression within parentheses as an indirect address. The 
following are examples of this type of assign statement: 

2. @(LCN + 8) = @LCN Place the contents of target memory 

location LCN in target memory loca- 
tion LCN + 8. 

_? @(WP + 16) = 345 Place the value 345 into target system 

memory location corresponding to the 
sum of the contents of the workspace 
pointer register plus 16. This location 
is workspace register 8. 

j*@(START+4) = #M0V *R0+,*R1# Assign the value of an instruction con- 

stant to location START + 4 in target 
system memory. 

An assign statement may be used to assign a value to every element of an array by entering the 
array name followed by the equal sign and the value to be assigned to the elements of the array. 
The following are examples of this type of assignment statement: 

2.NUM = 25 Assign the value 25 ( 1 9 x 6 ) to all 

elements of array NUM. 

?TABLE = 0100 Assign the value 100 I6 to all elements 

of array TABLE. 

The assign statement may be used to assign a value to an element of an array by entering the 
array name with one or two expressions in parentheses to specify the element of the array. The 
following are examples of this type of assign statement: 

?NUM(3) = 0D Assign the value D 16 to the third 

element of array NUM. 

2JABLE(3,2)=0400 Assign the value 400 j 6 to the element 

at row 3 of column 2 of array TABLE. 

4.6.3 DISPLAY STATEMENTS. A display statement displays the value of an expression. The 
syntax for a display statement using default display options is as follows: 

?<expression> 
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The value of the expression determines the variable or loeation to be displayed. The following 
are examples of display statements using delault options: 


7LCN1 

LCN1 = >01(1)4 


Prints value of user variable LCN1 as a hexa- 
decimal number (default). 


?PC 

PC = >$lQC 


Prints value of system variable PC' (target sys- 
tem Program Counter). 


?>200 + 46 
><Z)22E 


Prints the value of the expression. 


?@> 20 © 

>343A 


Prints value in location 200 16 ot target 
system memory. 


?_# JNE $-8# 
>16FA 

?_NUM ( 2 ) 
>(D0)19 


Display the value of an instruction constant. 


Display the value of element 2 of array NUM. 


4 6 3.1 Format Specification. The display statement may include a format speufuat on tor t c 
display The form of the display statement shown in the preceding paragraph uses the deb 
value The following is the syntax for a display statement using tormat speciiication characters. 


?<expression>:<format>. . . 

The expression has the same significance as in the syntax previously described. The colon 
indicates that one or more format speciiication characters tollow. 

The format specification characters are listed in table 4-2. An H specifies printing the displayed 
symbol followed by an equal sign. When it is used F should precede any^hcr 
because characters are effective in the order in winch they are en Uwd 

be displayed is an expression other than a single symbol, tormat character F. ign 

I -(Tnn it character B specifies a display in binary format, consisting ot a less than charactei (-1 
it b ' " d:gi. S (O r 1 and two spaces. When the B is followed by an optional 
ST through 9 that number of binary digits (starting with the east s.gmlican digi . , 
displayed. The specified number of digits is preceded by a less than character am ; 

two spaces. When the B is followed by the digit (). the display consists ol a kss Bum chan 
and 16 binary digits with no spaces separating the display from the following display. 

Format character D specifies a display in decimal format, consisting of a space or minus s'gn, 
one to five decimal digits (0 through 4). and two spaces. Leading zeros are replaces 
AMPL software converts the contents ot the word as a twos complement value. 

When the 1) is followed by an optional digit 1 through 5. that number of decimal digits (starting 
U,tb the least significant digit) is displayed. The specified number ot digits is preceded by a 
space o minus sign and followed by two spaces. When the D is followed by a digit 6 through 
9 the normal display occurs. When the 1) is followed by a 0, the normal display occurs but the 
two trailing spaces are omitted: no spaces separate the display trom the following display . 
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Table 4-2. Format Specification Characters 


Character Type of Display Note 

E Symbol and equal sign 

B Binary 1 

D Decimal 1 

U Unsigned decimal 1 

H Hexadecimal 1 

0 Octal 1 

A ASCII 

N Line feed and carriage return 2 

X Space 2 

1 Instruction 

S Symbolic address 


Notes: l. May optionally be followed by a single digit 0-9 to specify the 
number of digits to be displayed. 

2. May optionally be followed by a single digit 1-9 to specify the 
number of repetitions of the operation, or a single 0 to specify ten 
repetitions. 


Format character U specifies a display in unsigned decimal format, consisting of one to five 
decimal digits and two spaces. Leading zeros are leplaced by spaces, and the word is converted as 
an unsigned magnitude value. The U may be followed by a digit, which has the same significance 
as for decimal displays. 

Format character H specifies a display in hexadecimal format, consisting of a greater than 
character (>) followed by four hexadecimal digits (0 through 9, A through F) and two spaces. 
The H may be followed by a single digit. When the digit is 1 through 4, the display consists ot 
the greater than character followed by the specified number of digits and two spaces. When the 
digit is 5 through 9, the normal display occurs. A 0 results in a display consisting of a greater 
than character and four hexadecimal digits, with no spaces separating the display from the 
following display. 

Format character O specifies a display in octal format, consisting of an exclamation point (!) followed 
by six octal digits (0 through 7) and two spaces. When the O is followed by a digit 1 through 6, that 
number of octal digits (starting with the least significant digit) is displayed. The digits are preceded by 
an exclamation point and followed by two spaces. When the O is followed by a digit 7 through 9, the 
normal display occurs. When the O is followed by a 0, the normal display occurs but the two trailing 
spaces are omitted; no spaces separate the display from the following display. 


Format character A specifies a display in ASCII format. The 16-bit value ot the expression is 
translated into two 8-bit ASCII characters. A period is printed for the contents of any byte that 
does not contain a printable ASCII character. 
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I-'ormat character N causes a line feed and carriage return between displays. When the optional 
digit follows the N. the digit specifies a number of line leed and carriage return operations to be 
performed. The digit 0 specifies ten operations. 


Similarly, format character X provides an additional space between displays and may be followed by a 
decimal digit to provide up to ten spaces (a 0 specifies ten spaces). 

The I format character specifies the instruction display, which decodes the value as a machine 
instruction and displays the mnemonic operation code and operands as they could be specified in 
an assembly language statement. Further explanation and examples of the instruction display are 
included in the next paragraph. 

The S format character specifies a display of a symbolic address when applicable. The symbolic 
addresses are the module identifier, external definitions, external references, and addresses 
relative to the module identifier. The module identifier, external definitions, and unresolved 
external references are optionally loaded with the program. 

The value of an expression to be displayed in the S mode is compared to the load module 
symbols, and the symbol having the same value is printed. When the value of the expression is 
riot equal to the value of any load module symbol, the module identifier is printed followed by 
a plus sign and the hexadecimal address relative to the module identifier value (load address). In 
any of the following instances, the S display is replaced by an II display because the S display is 
not applicable: 

• No module has been loaded. 

• Module was loaded without defining load module symbols. 

• Load module symbols have been deleted. 

• Hxpression value is below lowest address or above highest address loaded. 

The initial default value of the format specification is ML which specifies displaying the symbol, 
the equal sign, and the value is hexadecimal format. The user may enter one or more lormat 
characters following the colon. When more than one lormat character lollows the colon, the 
characters apply in the order in which they are entered. I he following are examples ot display 
statements with several format characters: 

?>4154 : ANDHONB 
AT 

16724 >4154 1040)524 

<0100000101010100 


? PC : EHX2EBX4ED 

PC = >010E PC = <0000000100001110 PC = 270 

70100 : D303B9 
256 1400 <100000000 


_?>FFFF : DU 
-1 65535 

70104: DUS Assuming load module MYPROCi is loaded at location 100 t6 . 

260 260 MYPR0G.+ 0004 
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4.6. 3. 2 Instruction Display. The I format character causes the AMPL software to decode the 
value of the expression as a machine instruction. When the value decodes to an illegal operation 
code. AMPL software interprets the value as data, and lists a DATA directive with the 
hexadecimal equivalent of the value as the operand. When the value decodes to a two- or 
three-word instruction, AMPL software supplies one or two words of zeros and displays the 
result. The following are examples of display statements with I format characters: 

_?>C000: 1 
MOV R0,R0 

?>CFFF : I 

MOV *R15+,*R15+ 

?0E3:I 
DATA >00E3 

?>C802: I 
MOV R2 ,@>0000 


The software computes and stores the source and destination addresses as it decodes a value 
when the I character has been specified. System variable SRC contains the source address, and 
system variable DST contains the destination address. When the instruction does not have a 
source address, SRC is set to FFFF 16 , and when the instruction does not have a destination 
address, DST is set to FFFF 16 . The contents of variables SRC and DST are derived from the 
contents of the active workspace of the target system, and will only be valid when the 
workspace contents are valid. When displaying an instruction independently of emulation of the 
program, the user must check that the workspace registers contain the values that they will 
contain when the program is executed. The following example displays a value in the instruction 
mode, and then displays system variables SRC and DST: 

2>C7CF:I 
MOV R15,*R15 
_?SRC:H 
>FFF8 
?DST:H 
>23 FE 


Memory address FFF8 I6 is workspace register 15, the source address. Workspace register 15 
contains 23FE 16 , the destination address. 

AMPL software accumulates the total numbers of TMS 9900 clock cycles and TMS 9900 memory 
accesses for each instruction decoded in the instruction mode. The totals are set to zero following each 
instruction that modifies the program counter (jump or branch). System variable T1 M E is a switch that 
contols the display of these totals along with the display of each instruction. When T1 M E is set to one 
(using an assign statement), two values are displayed to the right of the line that displays the 
instruction. The leftmost ol these values contains the total of clock cycles, and the rightmost value 
contains the total of memory accesses. When a jump or branch is decoded, the totals are cleared 
following the display and an asterisk is displayed to the right of the values. The clock cycle total may be 
accessed as system variable CC and the memory access total may be accessed as system variable M C. 
The totals may be cleared with assign statements. The totals may be translated into time values by 
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multiplying the clock count total by the clock cycle time for the target system and the memory access 
total by the memory access time lor the portion ol target memory in which the access occurs. T here are 
several cases for which the number of clock cycles and memory access cycles cannot be stated exactly. 
The number of clock cycles for a shift instruction with a count of zero is a function of the contents of 
workspace register 0, which is dynamic. The software uses the maximum clock cycle count (52) in this 
case. Also, the conditional jump instructions require more clock cycles when the condition is true than 
when the condition is false. T he following are examples of statements to set TIME on, clear the totals, 
and display timing data: 


?T I ME = ON 
?CC = 0 
?MC = 0 
?>CFFF : I 

MOV *R15+ ,*R15+ 

30 

8 

?>C000: I 
MOV R0 ,R0 

44 

12 

?>1000:I 



JMP $+>0002 

54 

13 1 


The formula for translating the timing figures to total TMS 9900 execution times is as follows: 

T=, c(« (C + W * Ml 
in which: 

T = Execution Time 

t C ( 0 ) = Clock cycle time, typically 0.333 us. 

C = Number of clock cycles (value of CC, left column of example) 

W = Number of wait states per memory access (depends on type of memory) 

M = Number of memory accesses (value of MC, right column of example) 

For the set of instructions in the preceding example, assuming W = 0, the TMS 9900 execution time is: 
T = 0.333 * (54 + (0 * 13) = 0.333 * 54 - 17.982 us. 

The formula for translating the timing figures to total TMS 9980 execution times is as follows: 

T = Md>) (C + (W + 1) 2 * M) 

The symbols in the formula have the same meanings as in the TMS 9900 formula. For the set of 
instructions in the preceding example, assuming W = 0, the TMS 9980 execution time is: 

T = 0.333 * (54 + (0 + 1) * 2 * 13) = 26.64 M s 

4.6. 3. 3 Changing Default Format Specifications. The display statement examples in the pre- 
ceding paragraph include display specifications that apply only to the statement in which they 
appear. To change the default value the user may enter a G between the colon and the first 
character of the new format specification. The following are examples of statements that change 
the default format specification: 
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_?PC:GHN 

>34DE 


Change the default format specification to 
display the value in hexadecimal format and 
provide a carriage return. 


Change the default value, restoring the initial 
format specification. 

4.6. 3. 4 Displaying Target Memory. An option of the display statement may be used to display 
the contents of a range of locations in target system memory. The following is the syntax for 
the display statement option: 

?<addr>|6TO0<addr>[:<format>. . .] ?[:<format>. . .] 


?PC:GEH 
PC = >34DE 


Each addr operand may be any valid expression; its value is interpreted as an address in target 
memory. The first format specification applies to the display of the address; when it is omitted, 
the default format specification applies. The question mark (?) causes the display of the value of 
the expression to be followed by a display of the contents of the target system memory location 
corresponding to the value. The second format specification applies to the contents of the target 
system memory location; when it is omitted, the default format specification applies. 


The initial default format specification for either the value or the contents is H (for hexadecimal 
display). The user may change the default by entering a G and a new default format specifica- 
tion for either the value or the contents. The following is an example of a display of target 
system memory locations: 

7START = >20A6 ..ASSIGN STARTING ADDRESS TO START 
7.FINI = >20AE ..ASSIGN ENDING ADDRESS TO FINI 
_?START|tSTOjtSFINI? 

>20A6 / >0420 
>20A8 / >22A4 
>20AA / >C807 
>20AC / >21A6 
>2QAE / >0808 


Any valid expression can be used in place of START and FINI; a similar display can be obtained 
using system symbols. Assuming that the program counter contains 20A6 16 , the following 
example displays the same data with the I format character: 

2PC|6TO0PC+8?:I 
>2QA6 / BLWP @>22A4 


>20AA / MOV 

R7,@>21A6 

>20AE / MOV 

R8,0>21A8 


4. 6. 3. 5 Display and Modify. When used in a display statement having a single expression, the 
question mark allows the user to alter the contents of the target system memory location. 
Alternatively, the user may specify another location to be displayed. The following is the syntax 
for a display and modify statement: 

1 addr [ :<format>. . . ]?[ :<format>. . . ] 

The addr operand and the format specification have the same significance as in the syntax 
previously described. The difference is that following the display of the requested location, the 
user may enter one of the command characters listed in table 4-3 or an expression in response to 
the question mark printed by the software. The following is an example of a display and modify 
statement which alters the contents of the target system memory location: 
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Character 

= <expr> 


(« 


+ 


Table 4-3. Display and Modify Command Characters 

Meaning 

Evaluate the expression following the equal sign and 
place the value in the location that was displayed. The 
expression is restricted to consist of a variable, a 
constant, or a combination ol variables and or 
constants separated by arithmetic operators + or - only. 

Display the location corresponding to the displayed 
contents. Displayed value is used as an indirect address. 

Set the step mode to plus and display and modify the 
next word, or the next instruction when the I format 
character is in effect. 


Carriage 

Return 


:<format> . . . 


Set the step mode to minus and display and modify the 
preceding word. 

When the step mode is plus, display and modify the next 
word, or the next instruction when the I format charac- 
ter is in effect. When the step mode is minus, display and 
modify the preceding word. 

Alter the format specification for the contents of the 
target memory location. 

Terminate the display and modify operation. 


Note: When an expression is entered (not preceded by a command character), AMPL 
software evaluates the expression and displays the target system memory loca- 
tion that corresponds to that value. The user may modify that location as if it 
had been entered in a display and modify statement. The expression may be a 
system symbol: e.g., SRC or DST when the I format character applies. 

2PC?:H 

>20A6 / >0420 ? = >0460 

>20A6 / >0460 ? 


The result of this operation is to place 0460, 6 in location 20A6 16 of target system memory. 
Alternatively, the user could have entered an instruction constant, as follows: 

_?PC? :H 

20A6 / 0420 ? = #B @22A4# 

2BA6 / 0460 ? 
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The instruction constant shown in the preceding example is that of a two-word instruction Fntered in 
this mode, an instruction constant provides all words for multi-word instructions. L nfermg a carnage 
return after the system displays the question mark causes a display of the second word as follows: 

20A8 / >22A4 ? 

Alternatively, the user could have entered a + instead of the carriage return. The + sets the step mode 
to plus and accesses the next word. The step mode is plus initially, however, and a carriage return also 
accesses the next word. The + is required when the step mode has been set to minus, and it is desired to 
access the next word. The following example shows the result of entering the plus sign: 

>2<BA6 / >0460 ? + 

>20A8 / >22A4 ? 

The user may display the contents of address 22A4 16 by entering an @. The following example 
shows the result of entering an (° : 

>20A8 / >22A4 ? @ 

>20A4 / >22 D8 ? 

The user may change the format specification that applies to the target memory contents by 
entering a colon and a new format specification. The new specification does not alter the default 
values; it only applies to the current display. The following is an example: 

>22A4 / 22D8 ? :I 

>22A4 / COC *R8,R13 ? 

The user may display and modify any location in target system memory by entering an 
expression the value of which is a location in target memory. The expression may only contain 
variables, constants, or question marks. Only addition and subtraction operations may be used. 
In this context, the question mark signifies the current target system memory location. The 
following is an example of entering an expression: 

>22A4 / COC *R8,R13 ? ? + >A 

>22AE / >Q6A0 ? 

User and system symbols are expressions also. When in the instruction mode it is frequently 
useful to display the source address, as follows: 

>22AE / >06A0 ? : I 
>22AE / BL @>0074 ? SRC 
>4)074 / XMCTT 

The user may terminate the display and modify operation by entering a semicolon, as in the 
following example: 

>0074 / >Q4CQ ? ; 
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Using instruction constants in this mode is very effective because all words of the instruction are placed 
in target system memory. However the user must be aware that entering an instruction constant that 
supplies more words than the instruction that was previously stored at the location requires the user to 
enter the rest of the program again. Similarly, entering an instruction that supplies fewer words than 
the instruction it replaces requires the user to enter a NOP instruction or two, or to enter the rest of the 
program again. The following is an example of the problem: 


_? 0652? : I 

•0652 / MOV R7 ,@>01 04 ? = #M0V R7, R12# . . NEW INSTRUCTION USES ONLY ONE WORD 

>0652 / MOV R7, R12 ? 

>0654 / DATA >0104 ? = #M0V R8,@0106# . . REENTER NEXT INSTRUCTION 

>0654 / MOV R8,@>0106 ? 

>0658 / DATA >0106 ? = #M0V @040C,@040E# . . OLD INSTRUCTION USED TWO WORDS 

>0658 / MOV @>040C ,@>040E ? 

>065E / BLWP @>0206 ? ; . . BACK IN PROPER SEQUENCE-RETURN TO AMPL 


4.6.4 IF STATEMENTS. The IF statement contains one or two statements, one of which is 
executed depending on the result of evaluating an expression. The syntax for the statement is as 
follows: 

HF< express ion>$THEN0<statement>[)6ELSE|6<statement>] 

The expression is evaluated as a logical expression, yielding a true or false value. When the 
arithmetic value of an expression is zero, the logical value is false. The logical value of the 
expression is true when the arithmetic value is not zero. Execution of the statement depends on 
the evaluation, as shown in figure 4-2. When the logical value of the expression is true, the 
statement following the word THEN is executed, and another statement is requested. When the 
logical value of the expression is false, the statement following the word THEN is not executed. 
If the optional statement following the word ELSE has been included, this statement is 
executed; otherwise, another statement is requested. 

The statements within the IF statement may be any of the AMPL statements described in this 
section, including other IF statements. The statements may also be any of the user commands 
described in Section V. 


4-24 


Digital Systems Division 


946244-9701 




Figure 4-2. IF Statement Execution 


The following is an example of an IF statement: 

?_IFJ6PCJ6EQ0>106)6THENJ6R0 = >AAAA 

The example statement executes the assign statement that sets R0 to AAAA )6 when PC contains 
106 16 . Otherwise, the assignment statement is not executed. 

The following example shows an IF statement with the optional ELSE statement : 

?_I FJ6PCj6NE|6>100t6THENtS@PC : HI$ELSEJ4WP|6TOJ5WP+32 :B? :HD 

In the example, the software displays the instruction at the address in the program counter in 
hexadecimal and instruction format when the program counter contains a value other than 
100 16 . When the program counter contains 100 16 , the software displays the contents ot the 
target system workspace in hexadecimal and decimal format. 

4.6.5 CASE STATEMENTS. The CASE statement provides selective execution of a statement 
within a group of statements depending upon the value of an expression. The syntax (or the 
CASE statement is as follows: 

?CASE|ri<expr>0OF|(S<expr> : : <stmt> ; [<expr> : : <stmt> ;] . . . [tfELSE0<stmt>] ^END 
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The expression following the reserved word CASE is evaluated to use in selecting the statement 
to be executed. Reserved word OF is followed by a group of expression and statement pairs 
separated by two colons. When the value of the expression in one of these pairs is equal to the 
value of the first expression, the statement of the pair is executed. When the value of the first 
expression is not equal to the value of the expression in any pair, and the ELSE reserved word is 
included, the statement following reserved word ELSE is executed. When the optional ELSE 
statement is omitted, and the value of the first expression is not equal to the value of the 
expression in any pair, the CASE statement terminates. 

The expression and statement pairs and the ELSE statement may be entered on separate lines; a 
carriage return may be entered at any point following the reserved word OF. The following is an 


example of a CASE statement: 


?CASE#COUNT0MOD040OF 
1? 2: :C0UNT:X9D; 

1? 3: :C0UNT:X9X9D; 

1? 0: : COUNT :X9X9X9D; 

1? ELSEtfCOUNT : D 

17END 

Display COUNT in a position on a line 
according to the remainder when 
COUNT is divided by 4. 


The expressions may be entered in any order. An expression equal to 1 could be entered with 
the decimal display of COUNT instead of the ELSE statement shown. It is not necessary that an 
expression and statement be provided for each possible value of the first expression: normally, 
the ELSE statement is executed for more than one value, as in the following example: 

7CASE0VALUE0OF Set FLAG to one if VALUE is equal 

1? 25:: FLAG = ON; to 25 or 30; set FLAG to zero for 

1? 30:: FLAG = ON; other values. 

1? ELSEtfFLAG = OFF 
1? END 

4.6.6 WHILE STATEMENTS. The WHILE statement consists of an expression which is evalu- 
ated as a logical expression and a statement that is executed conditionally. The syntax for the 
WHILE statement is as follows: 

2.WHILEtf<expression>$D0#<statement> 

The expression is evaluted first, as shown in figure 4-3. When the value of the expression is false 
(zero), the remainder of the statement is ignored, and the software requests another statement. 
When the value of the expression is true (nonzero), the statement following the word DO is 
executed and the expression is reevaluated. As long as the expression remains true, the execution 
of the statement and the reevaluation of the expression are repeated. When the value of the 
expression becomes false, the statement is not executed and the software requests another 
statement. 

The statement following the word DO may be any of the AMPL statements described in this 
section, including another WHILE statement. The statement may also be any of the user 
commands described in Section V. However, execution of the statement should change the value 
of the expression; otherwise, the operation may never terminate. The following is an example of 
a WHILE statement: 

?WHILE|zSCOUNTJ6LE|t5100|fiDO0COUNT = COUNT + 2 
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Figure 4-3. WHILE Statement Execution 


If COUNT were greater than 100, initially, it would remain unaltered. If COUNT were less than 
or equal to 100 initially, it would be incremented by 2 repeatedly until it became greater than 
100. The final value of COUNT is either 101, 102, or its initial value (greater than 100). 

4.6.7 REPEAT STATEMENTS. The REPEAT statement consists of a statement that is executed 
at least once, and an expression which is evaluated as a logical expression. Subsequent execution 
is conditioned on the logical value of the expression. The syntax for the REPEAT statement is as 
follows: 

2REPEATtkstatement>J6UNTIL|6<expression> 

The statement is executed and the expression is evaluated, as shown in figure 4-4. When the 
value of the expression is true (nonzero), the AMPL software requests another statement. When 
the value of the expression is false (zero), the execution of the statement and the evaluation of 
the expression is repeated. Execution of the statement continues until the value of the expres- 
sion is true. 

The statement following the word REPEAT may be any of the AMPL statements described in 
this section, including another REPEAT statement. The statement may also be any of the user 
commands described in Section V. However, execution of the statement should change the value 
of the expression; otherwise, the operation may never terminate. 
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Figure 4-4. REPEAT Statement Execution 


The following is an example of a REPEAT statement: 

?_REPEAT)!SIF|6TALLY)6LE|60|z 5THEN|6TALLY = 240ELSE0TALLY = TALLY - IfcSUNTI L^TALL Yfe5EQt50 

The IF statement within the REPEAT statement is executed at least once. When TALLY lias a 
negative or zero value, TALLY is set to 24. Otherwise, TALLY is decremented by one. The 
expression TALLY EQ 0 is evaluated. The IF statement is repeated, decrementing TALLY until 
TALLY equals zero (TALLY EQ 0 is true). 

4.6.8 FOR STATEMENTS. A FOR statement assigns a value to a symbol and uses that symbol 
to control repeated execution of a statement. The syntax of the FOR statement is as iollows: 

?F0R#<symbo1 >=<expr>0TOt5<expr>[ti5BY)6<expr>] 0DO|tf<stmt> 

The symbol may be a user symbol or a system variable. It is assigned the value ot the expression 
that follows the equal sign, as shown in figure 4-5. Next, the software compares the value of the 
symbol to the value of the expression following the reserved word TO, and executes the 
statement following the reserved word DO if the values are not equal. I he software then 
increments the value of the symbol by the value of the expression that follows the reserved word 
BY, or by one when the BY expression is omitted. The software repeats the comparison and 
execution of ihe statement until the value of the symbol equals the value of the expression that 
follows the reserved word TO, and then terminates the operation. 
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Figure 4-5. Execution of FOR Statement 


The statement following the word DO may be any of the AMPL statements described in this 
section, including another FOR statement. The statement may also be any of the user commands 
described in Section V. When the BY expression is included, the difference of the terminal 
expression minus the initial expression must be an exact multiple of the increment expression; 
otherwise, the symbol will never be equal to the terminal value. 

The following is an example of a FOR statement to initialize values in column one ot a 
two-dimensioned array: 

7FOR0INDEX = l)6TO)65*6DOJ6MATRI X ( I NDEX , 1 ) = I NDEX 

Execution of the example statement places values 1 to 5 in rows 1 to 5 of column 1 of array 
MATRIX. The following is an example of a FOR statement that uses a BY expression; 

TFORtfN = 0|z5TO|68|t5BYtz52»6DO)6@(BUFF+N)=0 

This example statement stores zeros in four words ot target memory starting at address BUFF. 
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4.6.9 COMPOUND STATEMENTS. A compound statement is a sequence of AMPL statements 
treated as a single statement. The syntax for a compound statement is as follows: 

lBEGIN0<statement>[[;]<statement>] . . . 0END 

The statements following the word BEGIN may be any of the AMPL statements described in this 
section, including other compound statements. The statements may also be user commands 
described in Section V. 

A compound statement may be used at any point to organize statements into a block of 
statements that are executed after the reserved word I NI) is entered. A compound statement 
must be used when a statement cannot be entered on one line. The AMPL structure statements 
(IP. CASE, WHILE, REPEAT, and LOR) provide control over execution of one or more 
statements. By using compound statements within the structure statements a block ol statements 
is executed rather than a single statement as shown in the preceding examples. 

The following is an example of a compound statement: 

7BEGIN 

T? CC = 0; 

1? MC = 0; 

1? TIME = ON; 

1_? PC0TO0PC+20? : I ; 

12 TIME = OFF; 

E?END 

Execution of the statement begins when the END statement is entered. The compound statement 
in the example dears the dock and memory cycle counts, sets the system variable TIME ON, 
displays a set of instructions, sets TIME OFF, and terminates, without user intervention. 

The following is an example of the use of a compound statement with an IF statement: 

2IF0PC0EQ0>1060THEN0BEGIN 

11 CC = 0 

1? MC = 0 

1? PC0TO0PC+>100?:I 

1?END0ELSE0PC:EH 

This example tests system variable PC and executes a compound statement when PC is equal to 
1 06 16 . The compound statement contains two assign statements and a display statement. The 
assign statements clear the dock cycle and memory cycle counts. The display statement displays 
the contents of target system memory locations in instruction tormat. When PC is not equal to 
1 06 16 , the program counter contents is displayed in hexadecimal tormat. 
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Compound statements may be used within a CASE statement, as in the following example: 
?CASE|6LI NEJ60F 


1? 

10: :LINE :U 

. .DISPLAY LINE NUMBER ON 

1? 

20: :LINE :U 

..LINES 10 AND 20 

1? 

30: : BEGIN 

..DISPLAY LINE NUMBER 30 

2? 

LINE: UN 5 

2? 

LINE = 1 

..AND START NEW PAGE 

2? 

PAGE = PAGE + 1 


2? 

'PAGE'; PAGE :U3N 


2? 

END 


1? 

ELSE0 ' 

..BLANK LINE NUMBER COLUMN ON OTHER LINES 

1? 

END 



The preceding example assumes that the CASE statement is executed repeatedly along with a 
statement that displays a line of data and a statement that increments the line number. In that 
environment, the statement displays a line number on every 10th line and starts a new page on 
every 30th line. 


Similarly, a WHILE statement may include a compound statement, as in the following example: 

?_MAIN = >100 ... INITIALIZE SYMBOL 

?_N = 0 ... INITIALIZE COUNT 

^_WH I LEJ6NJ6LTJ680J6D0J6BEG I N 
1? @(MAIN + N) = >2020; 

1? N = N + 2 
17END 

The example stores ASCII spaces (20 16 ) in 80 consecutive bytes in target system memory. The 
first location is 100 16 . 

A REPEAT statement may also include a compound statement, as in the following example: 

?MAIN = >100 .. INITIALIZE SYMBOL 

_?BUFF = >320 .. INITIALIZE ADDRESS 

?N = 0 .. INITIALIZE COUNT 

7REPEAT0BEGIN 

1? @(MAIN + N) = @(BUFF + N) 

TJ_ N = N + 2 
17ENDJ6UNTIL0N0EQ010 

The example copies 5 words of target system memory from an area starting at location BUFF to 
an area starting at the location addressed by variable MAIN. 


The following is an example of a FOR statement that includes a compound statement: 


7F0RHSN = 0J5TOH100BY02HDO0BEGIN 
lT I F0@ ( DAT A+N ) 0AND00001$THEN0@ ( OATA+N ) :H 

1? ELSE0' EVEN NUMBER' 

1? @( DAT A+N) = @ (BUFF+N ) 

1? END 


..DISPLAY ODD NUMBERS IN TARGET MEMORY 
..ADDRESSES DATA THROUGH DATA + 10. 
..DISPLAY "EVEN NUMBER" FOR EVEN NUMBERS 
..MOVE VALUES FROM BUFF THROUGH BUFF + 10 
..INTO DATA THROUGH DATA + 10. 
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The example tests the contents of 10 target system memory locations starting at address DATA 
for odd numbers and displays the contents if odd, or a message if even. Then the example moves 
the contents of the corresponding location in an area beginning at address BUFF into the 
location. 

4.6.10 ESCAPE STATEMENTS. The ESCAPE statement causes termination of execution of the 
statements in a loop. The loop structures supported by AMPL software are the WHILE, 
REPEAT, and FOR statements. The syntax of the ESCAPE statement is as follows: 

7ESCAPE 

When an ESCAPE statement within a loop structure is executed, control passes to the statement 
that would have been executed at normal completion of the loop operation. When an ESCAPE 
statement is entered other than in a WHILE, REPEAT, or FOR statement, the AMPL softwa,. 
issues an error message. 

The following are examples of ESCAPE statements: 


JWHILEJ6N0LEJ6M0DOJ6BEGI N 

1? I FJ6DAT A+NJ5H I EJ6>1 FFFJ6THEN16ESCAPE ..TEST FOR ADDRESS ABOVE 1FFF 

1_? @(DATA+N) = 0 ..STORE ZERO IN ADDRESS 

E? N = N+2 
1? END 


7REPEAT0BEGIN 


1? 

I F0@ ( BUFFRO 0EQ0>4 140THEN0ESCAPE 

..TEST FOR AA IN BUFFER 

1? 

N = N+2 

..INCREMENT N 

1? 

PTR = BUFF + N 

..STORE NEXT ADDRESS IN PTR 


1?END0UNTIL0N=M 


2FOR0CNT = N0TO0M0DO0BEGIN 
12 IF0ADDR0HIE0 FFFE0THEN0ESCAPE 
12 OADDR = FFFF 
12 ADDR = ADDR+2 
i?END 


..TEST FOR ADDRESS ABOVE MEMORY ADDRESS SPACE 
..STORE -1 INTO ADDR 
..INCREMENT ADDR 


In each of the examples, the ESCAPE statement terminates the loop when a specified condition 
other than the condition of the loop occurs. 

4.6.11 NULL STATEMENTS. The NULL statement is a no operation statement. The syntax of 
the NULL statement is as follows: 

2NULL 

The NULL statement may be used at any time a no operation statement is appropriate. For 
example, in a WHILE or REPEAT statement in which the expression depends on a signal from 
hardware to terminate the operation, a NULL statement may be used following DO or REPEAT, 
respectively. 
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4.7 PROCEDURES AND FUNCTIONS 

AMPL supports procedures and functions written by the user. Procedures and functions are 
subroutines available for use in AMPL statements. A procedure is called by a procedure call 
statement and may define one or more arguments to be passed from the calling statement. A 
procedure consists of a definition statement that includes a single executable statement, typically 
a compound statement. A function call is used as a variable, the value of which is the value 
returned by the function. A function may define one or more arguments to be passed from the 
function call. A function consists of a definition statement that includes a single executable 
statement, typically a compound statement. A function should contain at least one return 
statement, either as the only statement, or as a statement within the compound statement. 

The statement of a procedure or function is not executed at the time the procedure or function 
is defined, but is executed each time the procedure or function is called. It is especially 
important to realize that an ARRAY statement in a procedure or function is not executed until 
the procedure or function is called. Any reference to an element of such an array is valid only 
after the procedure or function that contains the ARRAY statement has been called. 

4.7.1 PROCEDURE DEFINITION STATEMENT. The procedure definition (PROC) statement 
defines the statement that follows as a procedure and specifies the required number of arguments 
and optionally the number of words of local storage for the procedure. The syntax for the 
PROC statement is as follows: 

?PR0C)6<procedure name>[(<arguments>[,<local storage>] )]<statement> 

The procedure name operand is the name used to call the procedure; it must meet the 
requirements for user symbols listed in paragraph 4.2.3. 1, and must be unique with respect to 
other procedure names, function names, array names, and user symbols. The arguments operand 
is an integer constant having a value from zero through 255 that specifies the minimum number 
of arguments required by the procedure. When the procedure requires local storage, the local 
storage operand specifies the number of words of local storage required. The local storage 
operand is a positive integer constant less than 65,536. When the local storage operand is 
omitted, no local storage is provided for the procedure. When both operands are omitted, the 
value of zero is used for both operands. 

The following are examples of PROC statements: 

7PROC0DSPLY (4,10) BEGIN Defines the compound statement as pro- 

cedure DSPLY that requires at least four 
arguments and ten words of local storage 

7PROC0NAME (0) 'PROGRAM NAME IS' Defines procedure NAME to print a 

message that identifies the program 
name. 

4.7.2 FUNCTION DEFINITION STATEMENT. The function definition (FUNC) statement 
defines the statement that follows as a function, and specifies the required number of arguments 
and optionally the number of words of local storage for the function. The syntax tor the FUNC 
statement is as follows: 

?FUNC0<f unction name>[(< arguments>[,<local storage>]) ]<statement> 
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The function name operand is the name used in the function call; it must meet the requirements 
for user symbols listed in paragraph 4.2.3. 1 , and must be unique with respect to other function 
names, procedure names, array names, and user symbols. The arguments operand is an integer 
constant having a value from zero through 255 that specifies the minimum number of arguments 
required by the function. When the function requires local storage, the local storage operand 
specifies the number of words of local storage required. The local storage operand is a positive 
integer constant less than 65,536. When the local storage operand is omitted, no local storage is 
provided for the function. When both operands are omitted, the value of zero is used for both 
operands. 


The following are examples of FUNC statements: 

7FUNCJ4LSUM (3,2) BEGIN Defines the compound statement as 

function LSUM that requires at least 
three arguments and two words of local 
storage. 

?FUNC0ADDIT(2) BEGIN Defines the compound statement as 

“ function ADDIT that requires at least 

two arguments and no local storage. 


4.7.3 ARGUMENTS. The arguments for procedures and functions are placed in the call 
statement or function call. At least as many as are specified in the definition must be supplied. 
The unary operator ARG is used within the procedure or function to determine the number of 
arguments supplied in the call, and to access the arguments. The constant, variable, or sub- 
expression to which the operator ARG applies must evaluate to a positive integer value or zero. 
When the value is zero, the result is the number of arguments supplied in the call; when the 
value is a positive value, the operator and its operand access the argument corresponding to the 
value; i.e. , ARG 1 accesses the first argument (leftmost argument) in the call, ARG 2 the second, 
etc. The value of the operand of the ARG operator must not exceed the value of ARG 0. The 
ARG operator may be used to access an argument either for reading or writing, unless the value 
of the operand is zero; the value of ARG 0 may not be altered. A value stored in an argument is 
local to the procedure or function, and is not returned to the calling statement. 

The priority of unary operator ARG with respect to the operators listed in table 4-1 is 7 (highest 
priority). The following are examples of the use of unary operator ARG: 

ARGfe53 Accesses the third argument from the 

left in the set of arguments of a call to a 
procedure or function. 

ARGJ6N When N has a value greater than zero, 

and equal to or less than the number of 
arguments, accesses the corresponding 
argument. When the value of N is nega- 
tive or greater than the number of argu- 
ments, the expression is invalid. When 
the value of N is zero, accesses the 
number of arguments entered. 
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4.7.4 LOCAL STORAGE. A PROC or FUNC statement that has the optional local storage 
operand causes the software to reserve memory for local storage for the procedure or function. 
Local storage is provided each time the procedure or function is called, even though the call is 
nested within another call, and becomes inaccessible when the procedure or function terminates. 
Data cannot be passed between procedures and functions or between a procedure or function 
and the calling statement through local storage. 

The words of local storage are referenced by the unary operator LOC. The constant, variable, or 
subexpression to which the operator LOC applies must evaluate to an integer value greater than 
or equal to zero, and less than or equal to the number of words of local storage provided. When 
the operand evaluates to zero, the result is the number of words of local storage provided. When 
the value is a positive value, the operator and its operand access the word in local storage 
corresponding to the value; i.e.. LOC 1 accesses the first word, LOC 2 the second, etc. The LOC 
operator may be used to access a word for either reading or writing, except that the value of 
LOC 0 may not be altered. 

The priority of unary operator LOC with respect to the operators listed in table 4-1 is 7 (highest 
priority). The following are examples of the use of unary operator LOC: 

LOCfe54 Accesses the fourth word of local storage 

for the procedure or function. 

L0C|z5 ( NUM+3 ) When subexpression NUM+3 has a value 

greater than zero and less than or equal 
to the number of words of local storage, 
accesses the word of local storage that 
corresponds to the value. When the value 
of NUM+3 is negative or greater than 
the number of words of local storage, 
the expression is invalid. When the value 
of NUM+3 is zero, accesses the number 
of words of local storage allocated. 

4.7.5 RETURN STATEMENT. The RETURN statement terminates the execution of a function 
or a procedure. The syntax for a RETURN statement is as follows: 

7RETURN [0<expression>] 

The expression is evaluated, and when the statement appears in a function, the value is assigned 
to the function call. When the expression is omitted, and the RETURN statement is in a 
function, the value of zero is returned. When the RETURN statement is in a procedure, the 
expression is evaluated but the value is not returned. 

The RETURN statement is valid in a function, either as the only statement in the function, or as 
a part of the compound statement of the function. The RETURN statement is also valid in the 
compound statement of a procedure. The following is an example of a function that contains 
only a RETURN statement: 

?FUNC0SUM(2) RETURN 0ARG01 + ARG02 

This function returns the sum of the arguments as the value of the function call. Other examples 
of RETURN statements appear in examples in paragraph 4.7.7. 
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\ function that returns a value othei than zero to the tunction call must contain .1 HI il RN 
statement. 1 xecution ol a Rl I URN statement during execution ol a procedure 01 tunction 
terminates execution ol the procedure 01 function, and returns control to the calling statement 
An implicit RETURN with an operand of 0 occurs following the executable statement ol a 
procedure or function. A function that contains no explicit RI.TURN statement terminates at 
that point and returns a value of zero for the function call. 

4.7.6 CALLS TO PROCEDURES AND FUNCTIONS. A call to a procedure is an AMI’L 
statement consisting of the procedure name followed by arguments, if any, enclosed in paren- 
theses. The syntax of a procedure call is as follows: 

?<procedure name>[(<argument>[ ,<argument>] . . . )] 

The procedure name is a name that has previously been entered as the first operand of a PR(X 
statement. The user must enter the number of arguments specified in the PROC statement, and 
may enter as many more as desired. Arguments must be entered in the sequence required by the 
procedure Each argument is an expression. 

A procedure call may beentered whenever the software requests a statement, or within an IE. WWI 1 
REPEAT, or compound statement. A call to a procedure may be included in the same procedure 
(recursive call), m another procedure, or in a function. 

The following is an example of a procedure call: 

? DS PL i (LBL1 , LBL 1+8 ) Calls procedure DSPL1 specifying two 

arguments, LBL1 and LBl.1+8. ARC 0 
within the procedure returns 2. ARC I 
accesses L.B1J . and ARC 2 accesses 
I BE 1+8. 

A call to a function is used as a variable in an expression The value returned by flic function 
becomes the value of the v ariable. I lie function call consists ol the tunction name followed in 
arguments, if any. enclosed in parentheses. I lie syntax of a function call is as follows: 

<function name: [(<argument> [,<argument>] . . . )j 

The function name is a name that has previously been entered as the first opciand of a I UN( 
statement. 1 he user mint niter the number of arguments specified m the IT N< statement and 

mat enter as mans more desired. Arguments must be entered in the sequence required by the 

tunction. ! uh argument is an expression. 1 he operand ot the RI.TURN statement that 
terminates execution of tits Hmction becomes the value ol the function call. 

A function cad may be used in any A.Ml’I. expression. \ function sail may be used in the same 

function decursive call), in another function, or in 1 procedure. 1 he following ate examples, ol 
AM PI. statements that contain function calls: 

7STADD - SUM(BEGIN ,0FSCT) ^ •triable ST ADD is set to tlu- value ol 

the SUM Hmction of If l (.IN and 

Ol SI I 

?SUM(BEGIN ,0FSET ) + 1 0 : H D Display s the sum of the SI M tunction 

ol BIT, IN and Ol SET and 1 </! in hexa- 
decimal and decimal formal . 
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4.7.7 PROCEDURE AND FUNCTION EXAMPLES. The following is an example of a procedure 
definition: 


?PR0C(6DT (0,2) BEGIN 

. DUMP EMULATOR TRACE 

BUFFER 

(0 ARGUMENTS, 2 LOCAL VARIABLES) 

1? 

L0CJ61 = ETBO 

. GET INDEX OF OLDEST 

STORED 

VALUE 

1? 

LOCJ62 = ETBN 

. GET INDEX OF NEWEST 

STORED 

VALUE 

1? 

WHILE)6LOC)61)6LElSLOCt62)!SDO 



17 

BEGIN 




2? 

ETB ( LOC0 1 ) :H 

.DISPLAY TRACED VALUE 



2? 

@ETB(L0C)61) : HI N . 

.DISPLAY CONTENTS OF 

TRACED 

VALUE 

2? 

L0CI61 = L0CI61 + 1. 

.INCREMENT INDEX 



2? 

END 




1? 

RETURN 

■THIS STATEMENT MAY BE OMITTED 

1 TEND 





Procedure DT displays the contents of the emulator trace memory. On the assumption that the 
memory locations contain program counter values, the procedure also displays the contents ol 
these addresses. The procedure uses a command (ETB) and two system variables (ETBO and 
ETBN) which are described in Section V. The command reads a value from the trace memory, 
and the system variables contain the lower and upper index limits that define the portion of 
trace memory into which trace values have been stored. 

The PROC statement defines procedure DT with no arguments and two words of local storage. 
The procedure consists of a compound statement that contains two assign statements, a WHILE 
statement, and a RETURN statement. The first assign statement assigns the index value of the 
oldest value in trace memory (system variable ETBO) to LOC 1. The second assign statement 
assigns the index value of the newest value in memory (system variable ETBN) to LOC 2. The 
WHILE statement executes a compound statement repeatedly until local storage word 1 is greater 
than local storage word 2. The compound statement contains two display statements and an 
assign statement. The first display statement displays the contents of a trace memory location; 
the second display statement displays the contents of the displayed address in hexadecimal and 
instruction format. The assign statement increments the contents of local storage word 1 . 

The W'HILE statement terminates when the values stored in trace memory have all been 
displayed. The RETURN statement terminates execution of the procedure. If the RETURN 
statement is omitted, the implied RETURN provided at the end of every procedure terminates 
the procedure. The call for the procedure is as follows: 


?DT; 

The call for a procedure or function can include more arguments than the required number 
specified in the PROC or FUNC statement. Many procedures and functions, such as the 
preceding example, would ignore any arguments (or additional arguments). The following is an 
example of a procedure that requires one argument, but displays results (execution times) tor as 
many arguments as the user enters. 
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1PROC0T1MEN (1,1) BEGIN 
1? LOC^l = 1 
1? TIME = OFF 
1? WHILEPLOCtfltfLEtfARGJiSOtfDO 
1]_ BEGIN 

2? MC = 0 

2? CC = 0 

2? @ARG ( L0CJ61 ) : IXXXXX 

21 333 * (CC + MC) :DN 

2? LOC01 = L0C|61 + 1 

11 END 
1?END 

The example computes execution times of I MS 9900 instructions (other than branch or jump), 
assuming a clock cycle time of 333 ns and a single wait cycle. 1 he calling statement includes the 
locations to be displayed for which time is to be computed. 

Procedure II M IN contains a compound statement consisting ol two assign statements and a VV H 111 
statement. The first assign statement assigns the value ol I to 1 (X I to be used as an index to the 
arguments. The second assign statement sets system variable I IMF OFF to inhibit printing ol the 
\alues ol CC and MC in the display. The WHITE statement causes a compound statement to he 
executed for each argument. Within this compound statement, assign statements clear MC and CC. 
and display statements display the contents of the memory location corresponding to the argument in 
instruction format, and the computed execution time in decimal format. The last statement in the 
compound statement increments the index to access the next argument. The lollovvingareexamples ol 
statements that call procedure T1MEN: 

ITIMEN(START) 

?TI MEN (MAIN+10,MAIN+24 ,C0MP) 


Flic following is an example ol a function definition: 


7FUNC0MEMTST (3,1) BEGIN .. MEMORY TESTER (3 ARGUMENTS, 1 LOCAL VARIABLE 
1? L0( |S1 = ARGB1 .. SET LOCAL STORAGE WORD TC STARTING ADDRESS ARGUTE 'C 

2? WHI LEJ4LOCt51)6LOE|4ARGJ6210DO .. WRITE PHASE 
]T BEGIN 

21 0LOC01 = ARG03 

2_ L0 C (61 = L0CJS1 + 2 

21 end 

22 LUIJS1 = ARGJ61 ..SET LOCAL STORAGE WORT TO STARTING ADDRESS ARGUMENT 

U_ WM1 LEfefLOC^lt6LOEt5ARGt62fe5DO .. READ AND COMPARE PHASE 

]2 BEGIN 

21 I E|i@LOC01)6NE0ARGl&3|dTHEN|jRE7dRNl5LOC)61 .. ERCT EXIT 

22 LOC01 = L0C)41 + 2 

21 END 

22 RETURN#- 1 .. NORMAL EXIT 

1?END 
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CAUTION 


If the second argument for this function is equal to FFFF, 6 or if 
the first argument is an even address and the second argument is 
FFFE 16 , the function will not terminate properly, and will destroy 
the contents of low order memory if allowed to execute indefi- 
nitely. Incrementing FFFE 16 by 2 results in 0000 16 , which is 
lower than either FFFE 16 or FFFF 16 . 

Function MEMTST tests an area of memory as specified in three arguments. The first argument 
is the starting address in target system memory; the second argument is the ending address. The 
third argument is the test data to be used in the test. 

The FUNC statement defines function MEMTST with three arguments and a word of local 
storage. The function consists of a compound statement that contains an assign statement and a 
WHILE statement for the write phase, an assign statement and a WHILE statement for the read 
and compare phase, and a RETURN statement. The assign statement for the write phase sets the 
local storage word to the starting address in the first argument. The WHILE statement executes a 
compound statement repeatedly until the address in the local storage word is greater than the 
ending address in argument 2. The compound statement consists ol two assign statements. The 
first writes the test data word into the target system memory location specified by the local 
storage word. The second assign statement increments the contents ot the local storage word by 
two. The WHILE statement terminates when all words in the test area have been written. The 
assign statement for the read and compare phase sets the local storage word to the starting 
address. The WHILE statement executes a compound statement repeatedly until the address in 
the local storage word is greater than the ending address in argument 2. The compound 
statement consists of an IF statement and an assign statement. The IF statement executes a 
RETURN statement if the contents of memory are not equal to the test data in the third 
argument; this constitutes a memory error, and the address in the local storage word (the address 
that contains an error) is returned. When the contents of the memory location are correct, the 
assign statement is executed, incrementing the contents of the local storage word by two. The 
WHILE statement terminates when all words in the test area have been read and found to be 
correct. The RETURN statement provides a normal return, returning a -1 to identify the normal 
return. 

The following are examples of AMPL statements that call MEMTST : 

?TMTST = MEMTST (START .FINISH , >A5A5) .. TEST MEMORY 

jTFtfTMTSTtfNE0-10THEN0TMTST :D .. DISPLAY ERROR ADDRESS IF ERROR RETURN 

7BEGIN 

1? T ST DAT = >A5A5 ..INITIALIZE DATA FOR TEST 
1? TSTAD = >010® ..INITIALIZE STARTING ADDRESS 
1? TSTEND = >1000 ..INITIALIZE ENDING ADDRESS 
1? WHILE0TSTAD*SLO*STSTENDtfDO*SBEGIN 

2? TSTMEM = MEMTST (TSTAD .TSTEND, TSTDAT) .. TEST MEMORY 

2? I FJ6TSTMEM0EQJ6- 1J6THEN 

2_? TSTAD = TSTEND .. TEST COMPLETE 

2 1 ELSEJ6BEGIN 

3? TSTMEM :H .. DISPLAY ERROR ADDRESS 

3?_ TSTAD = TSTMEM +2 .. CONTINUE TEST BEGINNING AT 

3? END .. ADDRESS FOLLOWING ERROR 

2? END 

1?END 
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SECTION V 

SYSTEM OPERATION 


5.1 INTRODUCTION 

Prior to loading and operating the AM PL system, connect the target system to the host system through 
the emulator/ buffer module, the logic state trace data module, or both, as described in the installation 
and operation manuals for these modules. 

Operation of the system consists of loading the operating system, starting the AM PL program, and 
entering AMPL statements and commands. This section includes the loading procedures for TX990 
and for DX 10 and descriptions of the user commands. User commands are described in the following 
categories: 

• Target System Program Loading and Saving Commands 

• Utility Commands 

• CRU Commands 

• Data Input Commands 

• Emulator Operation Commands 

• Trace Module Operation Commands 

5.2 LOADING AND STARTING THE SYSTEM 

Loading and starting the system differs for TX990 and DX10 systems. The following paragraphs 
describe the procedures for the two operating systems. 

5.2.1 TX990. To load the AMPL system, perform the following steps: 

1. Place the AMPL system diskette in either floppy disk unit and place the unit in the Ready 
mode. 

NOTE 

Place the system disc in floppy disc unit 1 (left-hand unit), if possible. 

When the system disc is in unit 2 a limited set of error messages is 
printed (paragraph 6.2). 

2. Press the HALT/S1E switch on the programmer panel of the computer. 

3. Press the RESET switch on the programmer panel. 

4. Press the LOAD switch on the programmer panel. 

5. The computer should load TX990 from the diskette and print a message similar to the 
following when the loading has completed: 

TX990 SYSTEM 

MEMORY SIZE (WORDS): 24576 AVAILABLE: 12923 
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6. When a Model 91 1 VDT is used as system console, verily that the UPPER CASE LOCK key 
is in the upper case position for proper entry to TXDS and to the AM PL program. 


7. Enter an exclamation point (!) to activate the Terminal Executive Development System 
(TXDS). The computer prints a message similar to the following: 

TXDS 936215 ** 1/0 0:0 

PROGRAM: 

8. Place FS990 TXDS parts diskette in the other floppy disk unit (normally unit 2) and enter 
the following information to execute utility SYSUTL to initialize time and date. (If time and 
date information is not required, steps 8 and 9 may be omitted.) The following example 
shows entering data corresponding to 3:45 p.m., March 11, 1977: 

PROGRAM: DSC2:SYSUTL SYS 

INPUT: 

OUTPUT: 

OPTIONS : ID,1977,3,11,15,45. 

9. SYSULL executes the command, prints the following message, and returns control to 
TXDS: 

TX990 SYSTEM UTILITY 937544** 

15:45:00 MAR 11. 1977 

10. After executing the ID command, SYSUTL terminates. Control returns to TXDS, which 
prints a message similar to the following: 

TXDS 936215 ** 70/77 15:45 

PROGRAM: 

1 1. Enter the program name, followed by an asterisk. The asterisk specifies that the entry of 
input, output and options is not required. Enter the name as follows: 

PROGRAM: :A.MPl. SYS * 

12. The program begins execution, and prints a question mark requesting entry of a user 
command or an AM PL statement. The program is initialized to provide space for 30 user 
symbols. The user may require more than 30 symbols, or may not require that many. When 
fewer than 30 user symbols are required, specifying a smaller number allows more memory 
for procedures and functions. When deciding on symbol table requirements, allow space for 
module names and procedure and function names. The user may enter a CLR command 
with a positive integer operand to specify user symbol table size. The following is an example 
of a CLR command: 

_? CLR (25) Reserve space for 25 symbols in the user symbol 

table. 

13. Enter commands and statements as required. The program prints a question mark 
requesting entry at the completion of each command or statement: 
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5.2.2 DX10. To load the AM PL system, perform the following steps: 

1. Place the disk cartridge containing the DX10 system and the AM PL program on system 
disk unit 0. and place the unit in ready with write protection disabled. 

2. At the programmer panel of the computer, press the HALT/SIE switch. 

3. Press the RESET switch on the programmer panel. 

4. Press the LOAD switch on the programmer panel. 

5. When a Model 91 1 VDT is to be used as AMPL terminal, verify that the UPPER CASE 
LOCK key is in the upper case position for proper entry of System Command Interpreter 
commands and AMPL commands and statements. 

6. Press the blank orange key (upper right of keyboard) on the Model 91 1 VDT. 

7. Enter an exclamation point (!). The system displays a pair of brackets ([ ]) requesting entry 
of a command. 

8. Enter IS for an initialize system command. The system displays the following: 

INITIALIZE SYSTEM 
INITIALIZE SYSTEM LOG?: 

9. Enter YES. The system displays the following request: 

YEAR: 

10. Enter the current year; e.g., 1977. The system displays the following request: 

MONTH: 

1 1. Enter the number of the month; e.g., 9 for September. The system displays the following 
request: 

DAY: 

12. Enter the day of the month; e.g., 13. The system displays the following request: 

HOUR: 

13. Enter the hour (adding 12 to P.M. hours); e.g., 17 for 5 P.M. The system displays the 
following message: 

MINUTE: 

14. Enter the minute; e.g., 35. The system displays the following request: 

ATTENTION DEVICE: 
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1 5. Enter the device name of a terminal on which the system displays attention messages, or M I 
il the messages are to be displayed on the AM PL terminal. The system displays the following 
request: 

LOGGING DEVICE: 

16. Enter DU MY or the device name of a device to display system log messages. The system 
displays the following request: 

FILES?: 

17. Enter YES. The system displays the following request: 

PRIMARY FILE: 

IK. Enter 0. The system displays the following request: 

INITIAL ALLOCATION: 

19. Enter 100. The system displays a pair of brackets requesting another command. 

20. Enter AMPL. to activate the AMPL program. The system displays the following: 

AM PL MICROPROCESSOR PROTOTYPING LAB 
USER MEM (K) = 8 

21. Either enter another number instead of 8 and press the RETURN key. or press the 
RETURN key to specify 8. The number is the size in 1024 (IK) word blocks of memory 
required for the AMPl. system data and work area. The user may specify less than 8 when 
the work to be done does not require many procedures or functions and other users and 
other tasks require system resources. The user must specify more than 8 when the work to be 
done requires many long functions and procedures. T he system displays the followingfwith 
the applicable version number): 

AMPL 3.0 


22. If a symbol table size less than or greater than 30 symbols is required, enter a CLR command 
similar to the following to specify a symbol table size. When few symbols are required, a 
small symbol table provides more memory for procedures and functions. When deciding on 
symbol table requirements allow space for load module symbols and for procedure and 
function names. The CLR command is as follows: 

_? CLR (45) Reserve space for 45 symbols in the user symbol 

table. 

23. The AMPL system displays a question mark. (?) to request a command or statement at the 
completion of execution of each command or statement. Enter commands and statements as 
required. 
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5.3 HARDWARE DEMONSTRATION TEST 

The AM PL software includes a hardware demonstration test that verifies the installation of the 
emulator and trace modules. It should be executed following the initial loading of the AM PL program. 
The hardware demonstration test is not a diagnostic test of the emulator and trace modules. However, 
it may be executed at any time you desire to exercise the emulator and trace modules. Perform the 
following steps to execute the test immediately after loading and starting the AMPL program: 

1 . Enter a COPY command to load the test. Use the applicable one of the following examples, 
followed by a carriage return: 

? COPY (‘:AMPHDT, PRC’) For a TX990 system, or 

? COPY (‘.SSSYSLIB.AMPLSLIB.AMPHDT’) For a DXIO system. 

2. When the AMPL program has loaded the procedures for the test, it displays operating 
instructions. Follow the instructions in each display, entering the following as requested. 

^2 C 

3. When C is entered following the third group of instructions, the test begins. The first test 
consists of displaying instructions for entering the EINT command to initialize the 
emulator. Use the applicable one of the following examples: 

2 EINT (‘EMU’) TX990 system 

1 EINT (‘EMOU) DXIO system 

4. The AMPL software responds by displaying a question mark when the initialization 
completes satisfactorily. The system displays an error message when initialization fails. A 
typical error that might occur during an initialization attempt displays the following 
message: 

*** ERROR 205>0700 >0001 
EMULATOR DSR ERROR: 

>02XX = ILLEGAL OPERATION 
>06 XX = OPERATION TIMED OUT 
>07XX = DEVICE ERROR 

If any error message is displayed, verify the connections to the emulator, and verify that the 
emulator module is firmly seated in the proper slot. Then repeat the command. 

5. When the emulator has been successfully initialized, enter the following command to resume 
the test: 

? AMPHDT; 

6. The second test displays the following title, and clears and sets the two system variables that 
map target system memory addresses into emulator memory. Normally the test completes 
with no further message. 

-EMULATOR MEMORY SELECTION TEST- 
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f ailure ot the test is indicated by an error message; typically, t he error message shown in step 
4 is displayed. If an error message is displayed, verily that the microprocessor connector ol 
the buffer is not connected to anything, or is not contacting anv electrically conductive 
material. Should the microprocessor connector be connected to a target system, both the 
emulator and the target system are being tested. Disconnect the microprocessor connector 
to isolate the problem. 


7. After successfully completing the second test, the software begins the third test by displaying 
the following title: 

-EMULATOR USER MEMORY TEST (4K WORDS)- 

I he test consists of writing the memory address into the addressed location, beginning at 
address 0. 7 he test then reads the tested address, and compares the contents to the address. 
When the comparison is equal, the test continues by adding 32 to the tested address, and 
repeating the test, until the range of addresses, 0 through 1FE0 I6 . has been tested. When the 
comparison is not equal, the test displays the following title; 

*** ERROR: EMULATOR USER MEMORY ERROR 

T he test may be repeated by entering the following command. If the failure persists, refer the 
problem to maintenance personnel. 

_? AM PHOT; 

8. After successfully completing the third test, the software begins the f ourth test by display ing 
the following title: 

-EMULATOR TRACE BUFFER MEMORY TEST (256 WORDS)- 

Fhe test is similar to the user memory test, except that all even addresses from FEOOh, 
through FEE Eia are tested. If the test software detects an error, it displays the following 
message: 

*** ERROR: EMULATOR TRACE MEMORY FAILURE 
Recover from the eiror as described in step 7. 

9. After successfully completing the fourth test, the software begins the fifth test by displaying 
the following title: 


-EMULATOR RUN TEST- 

1 he test writes a simple program into target memory, consisting of four instructions, the last 
of which is an IDEE instruction. The test then sets up the emulator to execute with no 
tracing or breakpoint, and issues a command to start the emulator. The program in memory 
executes, placing the microprocessor in the idle mode The test verifies that the 
microprocessor is executing an IDEE instruction. If the status ot the microprocessor 
indicates that the microprocessor is not executing, or is not executing an IDEE instruction, 
the test program displays the following message: 

*** ERROR: EMULATOR EXECUTION FAILURE' 
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If the test fails, refer the problem to maintenance personnel. Repeat the test by entering the 
following: 

? AMPHDT; 

10. After successfully completing the fifth test, the software begins the sixth test by displaying 
the following title: 

-EMULATOR HALT TEST- 

The test executes an emulator command to halt the emulator, and verifies that the emulator 
halts. If the status of the microprocessor indicates that the emulator did not halt, the test 
displays the following message: 

*** ERROR: EMULATOR FAILED TO HALT PROPERLY 
Recover from the error as described in step 9. 

11. After successfully completing the sixth test, the software begins the seventh test by 
displaying the following title: 

-EMULATOR TRACE TEST- 

The test sets up a trace of the program in target memory, and a breakpoint at completion of 
the trace operation. The test then re-executes the program in target memory, and verifies 
that the trace operation traced properly and halted the operation. When the trace operation 
fails, the test displays the following message: 

*** ERROR: EMULATOR FAILED TRACE TEST 

Recover from the error as described in step 9. 

12. After successfully completing the seventh test, the software begins the eighth test by 
displaying the following title: 

-EMULATOR ADDRESS COMPARISON TEST- 

The test sets up a breakpoint at an instruction address, and re-executes the program in target 
memory. The test then verifies that the breakpoint stopped the emulator at the proper point. 
When the breakpoint operation fails, the test displays the following message: 

*** ERROR: EMULATOR FAILED PC BREAKPOINT 

Recover from the error as described in step 9. 

13. At this point, emulator tests have been completed, and the test displays the following 
message: 

*** EMULATOR PASSES HARDWARE DEMONSTRATION TEST *** 

DO YOU WISH TO TEST A LOGIC STATE TRACE MODULE? (Y=YES, 
N=NO) 

If the system being tested includes a trace module, enter Y; otherwise, enter N. and skip 
to step 20. 
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14. When the user requests testing a traee module, the test displays instructions lorentering the 
I INI command to initialize the trace module. Use the applicable one of' the following 
examples: 

TINT (‘TRA’) TX990 system 

TINT (‘T MOD DX 10 system 

I he software responds by displaying a question mark when the initialization is complete. 
The software displays an error message when intialization fails. A typical error that might 
occur during an initialization attempt displays the following message: 

*** ERROR 219 0700 0001 

TRACE MODULE DSR ERROR: 

02XX = ILLEGAL WHILE TRACING, 

06 XX = OPERATION ABORTED 

07XX = TRACE MODULE DEVICE ERROR 

II anv error message is displayed, verify the connections to the trace module, and verify that 
the trace module is firmly seated in the proper slot. Then repeat the command. 

When the trace module has been successfully initialized, enter the following command to 
resume the test: 

? AMPHDT; 

15. The software begins the first trace module test by displaying the following title: 

-TRACE MODULE INTERNAL CLOCK TEST- 

I he test sets up the emulator to execute with no breakpoints or tracing, and sets up the trace 
module to trace using the internal clock, and to halt after tracing 10 items. The test then re- 
executes the program in target memory, and verifies that the trace operation halted the trace 
module. When the status of the trace module indicates that tracing did not stop or that 
something other than completion of the trace operation halted the trace module, the test 
displays the following message: 

*** ERROR: TRACE MODULE FAILED INTERNAL CLOCK TEST 
Recover from the error as described in step 9. 

1 6. After successfully completing the first trace module test, the software begins the second test 
by displaying the following title: 

-TRACE MODULE DATA TRACE TEST- 

The test sets up the trace module to trace data using external (emulator) clock. 1 he test also 
sets the trace module to halt the emulator at the completion of the instruction that completes 
the trace operation. The test then re-executes the program in target memory, and verifies 
that the completion of the trace operation halted the emulator and the trace module, and 
that the trace operation correctly traced the data. When the status of the emulator and trace 
modules indicates that the test failed, the test displays the following message: 

*** ERROR: I R ACE MODULI FAILED DATA TRACE 

Recover from the c t rot as described in step u . 
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1 7. After successfully completing the second trace module test, the software begins the third test 
by displaying the following title: 

-TRACE MODULE EVENT TEST- 

The test sets up the trace module to breakpoint on the first instruction of the program in 
target memory, and re-executes that program. The test then verifies that both the emulator 
and trace modules halted, and that the breakpoint halted the modules. When the status of 
the emulator and trace modules indicates that the breakpoint failed, the test displays the 
following message: 

*** ERROR: TRACE MODULE EVENT FAILURE 
Recover from the error as described in step 9. 

18. After successfully completing the third trace module test, the software begins the fourth test 
by displaying the following title: 

-TRACE MODULE: TRACE DELAY TEST- 

The test uses the same breakpoint set up for the preceding test, but sets up a delay of halting 
the emulator and trace modules following the breakpoint. The test then re-executes the 
program in target memory, and verifies that the breakpoint executed properly after the 
specified delay. When the status of the emulator and trace modules indicates that the 
breakpoint or delay failed, the test displays the following message: 

*** ERROR: TRACE MODULE DELAY FAILURE 
Recover from the error as described in step 9. 

19. After successfully completing the fourth trace module test, the software displays the 
following message: 

*** TRACE MODULE PASSES HARDWARE DEMONSTRATION TEST *** 

20. The test then displays the concluding message, as follows: 

*** CONCLUSION OF AMPL HARDWARE DEMONSTRATION TEST *** 
5.4 RECOVERY PROCEDURE 

The buffer modules contain a switch that connects the clock source for the microprocessor to the clock 
in the emulator or to the clock in the target system. Setting the CLOCK switch to a different position 
during a debugging session requires a recovery procedure to be performed before continuing the test. A 
similar recovery procedure is required when the power to the target system is disconnected and then 
restored. When the TMS 9900 buffer module is in use, observe the following rules: 

• Avoid altering the CLOCK switch setting or interrupting power to the target system while 
the emulator is running. Should this occur inadvertently, restart as described in paragraph 
5.2. 

• After switching clock sources or restoring power with the emulator halted, enter an EINT 
command (paragraph 5.10.1) and restore contents of target system memory. 
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When the TMS 9980 buffer module is in use, recovery is the same as described for the TMS 9900 buffer 
except that a restart is not necessary. An EINT command must be entered to recover in all cases, and 
target system memory contents must be restored. 


5.5 ENTERING COMMANDS 

The user may enter commands and AMPL statements interchangeably. However, when a compound 
statement contains a CLR, RSTR, EDIT, or COPY command, execution of the compound statement 
terminates at completion of the CLR, RSTR, EDIT, or COPY command. Any statement or command 
following any of these commands within a compound statement is not executed. 

Any command or statement may be terminated by a semicolon to promote clarity. There are several 
instances in which semicolons are required to prevent ambiguity. It is good practice to place a 
semicolon following each statement within a CASE statement. This prevents the expression that 
follows from being interpreted as a continuation of the statement. It is also a good practice to place a 
semicolon following each command that has no operands; otherwise an expression within parentheses 
that follows the command is taken as a group of operands and ignored. 

Execution of any command can be terminated and control returned to the AMPL program by pressing 
a key on the system console. When the system console is a 913 VDT, press the HELP key; when the 
console is the 91 1 VDT, press the CMD key; when the console is the 733 ASR, hold the CNTRL key 
while pressing the X key. 

System variables YR, DAY, HR, MIN, and SEC may be used to add time and date information in the 
listings of AMPL statements, commands and results. These may be displayed but not assigned new 
values. The following example shows the use of these variables: 


?HR:D2 

14 

Hour of the day. Value shown corresponds 
to 2 P.M. 

?MIN:D2 

ii 

Minutes past the hour. 

?SEC:D2 

23 

Seconds past the minute. 

?DAY:D3 

133 

Day of the year. Value shown corresponds 
to May 13. 

?YR:D4 

Year. 


1977 


5.6 PROGRAM COMMANDS 

AMPL software supports two commands to load and save programs in target memory. The LOAD 
command loads a relocatable object module or an absolute module from a diskette file into target 
system memory. Optionally, the command defines load module symbols. The DUMP command stores 
a program from target system memory on a diskette file in absolute format. 

5.6.1 LOAD COMMAND. The LOAD command loads a relocatable module in either standard or 
compressed object format or an absolute module into target system memory. It performs relocation 
lunctions for relocatable object modules using the bias value specified in the command. The syntax for 
a LOAD command is as follows: 

?LOAD('<access>’[,<bias>[, [IDT] [+REF] [+DEF] ]]) 
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The access name is a character string that contains the name of the module to be loaded. The name of 
the module is a name that is acceptable to the operating system; e.g., a TX990 file name, or a DX10 
pathname or synonym. The bias is the address in target memory into which the first word of a 
relocatable object module is loaded. When the bias operand is omitted and a relocatable module is to 
be loaded, the default value of A0i 6 is used. When an absolute module is to be loaded, it is loaded at the 
same locations from which it was stored, and the bias operand is ignored. 

The third operand consists of one or more of the keywords IDT, REF, and DEF (separated by plus 
signs) or the keyword OFF. When the operand is omitted, or when all keywords are entered, the load 
module identifiers, external definitions, and unresolved external references are defined in the symbol 
table as load module symbols. Keyword IDT causes the load module identifier to be defined; keyword 
REF causes unresolved external references to be defined; and keyword DEF causes external 
definitions to be defined. One, two, or all of these keywords may be used, or the keyword OFF may be 
used to load a module without defining any load module symbols. 

1 he user may display the values of any of the three types of load module symbols. The value of an 
unresolved external reference is the target memory address of the end of a linked list of target memory 
locations that require the value of the external reference. Procedure RESOLV (Appendix G) may be 
called to assign a value to these locations, and the external reference may also be assigned that value. 
However, the user must supply the address of the end of the linked list, i.e., the initial value of the 
reference, to procedure RESOLV. The user may not alter the values of external definitions or load 
module identifiers. 

The following are examples of LOAD commands using TX990 file names; 

7LOAD (‘:MEMOBJ/OBJ\>FEOO) Load object file MEMOBJ/OBJ into 

target system memory starting at address 
FE00i6, defining all load module symbols. 

^?LOAD (TMEMABS/ ABS’) Load absolute file MEMABS/ABS into 

target system memory at address supplied 
in the file. 

^LOAD (‘:MYPROG/OBJ\ 0100, IDT) Load an object file having a synonym of 

FILE1 MYPROG/OBJ into target 
system memory starting at address 100i 6 , 
defining load module identifiers only. 

The following are examples of LOAD commands using DX10 pathnames and synonyms: 

l LOAD (‘VAM PL.OBJ.MEMOBJ\>FEOO) Load object file VAMPL.OBJ.MEMOBJ 

into target system memory starting at 
address FE00i6, defining all load module 
symbols. 

? LOAD (‘VAMPL.ABS.MEMABS’) Load absolute file VAMPL.ABS. 

MEMABS into target system memory at 
address supplied in the file. 

? LOAD ( l FILEl‘,0100,IDT) Load an ojbect file having the synonym 

FILE1 into target system memory starting 
at address IOO 16 , defining load module 
identifiers only. 
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The LOAD command does not support image files or segmentation tags. If the object code contains a 
tag other than 0 through F or 1. an error occurs when the loader attempts to process the tag. The object 
module may be link edited by either SDS LIN K or TXSLNK to obtain a module that may be loaded by 
the LOAD command. However, no load module symbols are defined unless the SYMT option is used 
both in assembly and link editing, and then only the module identifier is defined. 

5.6.2 DUMP COMMAND. The DUMP command stores a program on a specified file from specified 
locations in target system memory. Optionally, the command also stores a specified entry point. The 
syntax for a DUMP command is as follows: 

?DUMP f<access name>’,<start>,<end>[,<entry>]) 


The access name is a character string that contains the name of the file on which the program is to be 
stored. The name of the file is a name that is acceptable to the operating system; e.g., a TX990 file name, 
or a DX10 pathname or synonym. When the files does not exist, AM PL software creates a file. When 
the tile contains data, the program replaces the previous contents of the file. The start operand is the 
address of the first word to be stored, and the end operand is the address of the last word to be stored. 
I he entry operand is the address of the entry point of the stored program. 

The DU M P command stores a program in absolute format. When the entry operand is specified, the 
value is placed in the program counter of the emulator when the program is loaded. Files written by the 
DUMP command may be reloaded by the LOAD command which restores the program in target 
memory for further testing and debugging. 

The following is an example of a DUMP command using a TX990 pathname: 


? DUMP ( .MEMABS/ ABS ,>FE00,>FE46,>FE26) Store target memory contents 

beginning at address FE00i 6 
and ending at address FE46 i 6 
on file MEMABS/ ABS, and 
store FE26i6 as the entry point 
for the program. 

The following is an example of a DUMP command using a DX10 pathname: 


? DUMP (‘ VAMPL. ABS. MEMABS’, >FE00,>FE46,>FE26) 


5.7 UTILITY COMMANDS 

AM PL software supports the following utility commands: 


Stores target memory 
contents beginning at ad- 
dress FE00 16 and end- 
ing at address FE46 i 6 
on file VAMPL.ABS. 
MEMABS, and store 
FE26 16 as the entry point 
for the program. 


• Define Console (CNSL) 

• Define Listing Device (LIST) 

• Multiply (MPY) 

• Divide (DIV) 


5-12 


Digital Systems Division 


946244-9701 



• Display Register Contents (DR) 


• Display User Symbol Table (USYM) 

• Display Load Module Symbol Table (MSYM) 

• Delete Load Module Symbol Table (MDEL) 

• Display System Symbol Table (SSYM) 

• Save Test Environment (SAVE) 

• Clear Test Environment (CLR) 

• Restore Test Environment (RSTR) 

• Enter Text Editor (EDIT) 

• Copy Input (COPY) 

• Delete Procedure (DELE) 

• Delay AMPL Execution (WAIT) 

• Output New Line (NL) 

• Verify (VRFY) 

• Terminate AMPL Program (EXIT) 

5.7.1 DEFINE CONSOLE COMMAND. The Define Console command (CNSL) defines an 
alternate device to replace the device currently being used as system console, or switches the output to 
the console on and off. The syntax for the CNSL command is as follows: 

| ‘<device name>’ 

OFF ) 

ON 

The device name is a character string that contains the device name (as defined for the operating 
system) of a console device to replace the current system console. The keyword OFF causes output to 
the system console to be disabled. The keyword ON causes output to the system console to be 
reenabled following entry of a CNSL command with the OFF keyword. When a CNSL command is 
entered with a device name operand, the named device displays the question mark requesting a new 
command at the completion of this command. When a CNSL command is entered with the keyword 
ON the previously defined system console displays the question mark at the completion of this 
comand. The following are examples of CNSL commands: 

? CNSL (‘ASR’) The 733 ASR replaces the system console 

(TX990). 

2 CNSL (‘ST07’) The terminal ST07 replaces the system- 

assigned console terminal (DX10). 

Execution of a CNSL command in a DX 10 system does not affect the synonyms assigned to the AMPL 
terminal. The synonyms defined at the terminal from which AMPL was called continue to apply. 
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5.7.2 DEFINE LISTING DEVICE COMMAND. The Define Listing Device command (LIST) 
defines a supplementary listing device or file, or stops or starts supplementary listing. While listing is 
on, all data displayed on the system console is also displayed on the listing device or written to the 
listing file. The following is the syntax for the LIST command: 


?LIST( 


<access name> 
OFF 
ON 


) 


The operand is a character string that contains a pathname or either of the reserved words OFF or ON. 
A TX990 pathname may be that of a device or file; a DX10 pathname may be a device name, a file 
pathname, or a synonym. The pathname is that of a device or file to display or store the supplementary 
listing. When the pathname is that of a file that does not exist, AM PL software creates the file. When 
the file already contains data, the data in the file is replaced by the new data. When OFF is entered, 
supplementary output is terminated. Reserved word ON is only valid when reserved word OFF has 
been entered in a previous LIST command, and restores supplementary output to the device or file that 
was previously defined for supplementary output. A LIS I command with a new pathname may be 
entered at any time; the device or tile previously defined is closed and the newly defined device or file is 
opened and output begins. 


The following is an example of a series of LIST 
?LIST(‘:OFILE/ LST’) 

?LIST(‘LP’) 

J?LIST(‘:OFILE/LST’) 


commands using TX990 pathnames: 

Write supplementary output on file 
DSC:OFILE/LST. 

Print supplementary output on Line 
Printer instead of writing to 
DSC:OFILE/ LST. 

Write supplementary output on file 
DSC:OFILE/LST replacing previously 
written output. Terminate output to Line 
Printer. 


?LIST(OFF) 

?LIST(ON) 

1 he following is an example of a series of LIS 
?LIST(‘ VAMPL.LST.OFILE’) 

.?LIST(‘LP0r) 

J?LIST(‘VAMPL.LST.OFILE’) 


Terminate supplementary output, 
displaying output on system console only. 

Resume supplementary output, adding it 
to file DSC:OFILE/ LST, following 
previously written output. 

commands using DX10 pathnames: 

Write supplementary output on file 
VAMPL.LST.OFILE. 

Print supplementary output on Line 
Printer instead of writing to 
VAMPL.LST.OFILE. 

Write supplementary output on file 
VAMPL.LST.OFILE replacing 
previously written output. Terminate 
output to Line Printer. 
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?LlST(OFF) Terminate supplementary output, 

displaying output on system console only. 

?LIST(ON) Resume supplementary output, adding it 

to file VAMPL.LST.OFILE following 
previously written output. 

5.7.3 MULTIPLY COMMAND. The Multiply command (MPY) is a system function that multiplies 
two 16-bit unsigned numbers and returns the least significant 16 bits of the product. The most 
significant 16 bits of the product are stored in system variable M DR. The syntax of the M PY command 
is as follows: 


?MPY(<multiplicand>,<multiplier>) 


The operands are expressions, the 16-bit values of which are multipled as unsigned numbers. The 
following is an example of an MPY command: 


_? MPY (24,10) 
MPY = >00FQ 


Multiply 24 times 10. 


I MDR 

MDR = >0000 


Obtain the most significant half of the 
product. The complete product is 
000000 F0, 6 , or 240. 


Alternatively, the command and its operands may be used as an expression in an AM PL statement. 
The value of the expression is the 16 low-order bits of the product. Variable MDR contains the 16 high- 
order bits of the product. The following is an example of an AMPL statement that contains an MPY 
command: 


7REPEAT0N = N + IfSUNTILtfMPY ( CNT,N )0GT01 000 Increment N by 1 until the least 

significant half of the product is 
greater than 1000. Unless the pro- 
duct of the initial value of CNT 
times N + 1 is greater than 65,535 
MDR contains zero. 


5.7.4 DIVIDE COMMAND. The Divide command (DIV) is a system function that divides a 32-bit 
unsigned number by a 1 6-bit unsigned number, and returns the 1 6-bit quotient. The most significant 1 6 
bits of the dividend must be placed in system variable MDR prior to executing the command. The 
remainder is in MDR following the operation. The syntax of the DIV command is as follows: 

?DIV(<divisor>,<dividend>) 

The operands are expressions. The 16-bit value of the dividend operand is combined with the value of 
MDR and is divided by the 16-bit value of the divisor operand. The following is an example of an 
assign statement that places the high-order portion of the dividend in MDR, and a DIV command: 

Divide 10000 16 (65,536) by 59. 


Display remainder. 


Alternatively, the command and its operands may be used as an expression in an AMPL statement. 
The value of the expression is the quotient, and variable MDR contains the remainder. The following 
is an example of an AMPL statement that contains DIV command: 


l MDR = 01 
1 DIV (59,0) 
DIV = >0456 
l MDR 

MDR = >002E 
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? DISP = DEST - PC + 2 
]_ MDR = 0 

? DISP - DIV(2,DISP) 

? I FfciMDRIzSNEbSObSTHENbi 'ERROR* 


Initialize DISP. 

Set MDR to most significant half of 
dividend. 

Compute displacement for jump to DEST 
when DEST is greater than contents of 
PC. 

Display ERROR if DEST has an odd 
value. 


5.7.5 DISPLAY REGISTER COMMAND. The Display Register command (DR) displays the 
contents of the target system program counter, workspace pointer, and status register, the contents of 
the address in the program counter, and the contents of workspace registers 0 through 15 of the current 
target system workspace. The contents are displayed in hexadecimal format and the contents of the 
address in the program counter are also displayed in instruction format. The syntax for the command 
is as follows: 


?DR; 


The following is an e 

xample of the DR command showing the resulting display: 

R0 

? DR; 

= >0030 R8 

= >0000 PC = >01 2E / >0601 DEC Rl 

RI 

= >0F98 R9 

= >0000 WP = >0134 

R2 

= >FFFF Rl 0 

>0000 ST = >D000 

R3 

= >FFFF Rl 1 

= >010E 

R4 

= >FFFF R12 

= >1 FE0 

R5 

= >FFFF R13 

= >0000 

R6 

= >0000 Rl 4 

= >0000 

R7 

= >0000 Rl 5 

= >0000 


5.7.6 DISPLAY USER SYMBOL TABLE COMMAND. The Display User Symbol Table command 
(IJSYM) displays a list of all user symbols, the symbol types, and the symbol values. The display 
includes a count of the symbols also. The syntax for the command is as follows: 

_?USYM; 

The A MPT software prints one of the following symbol types after each symbol: 

VAR Variable 

PROC Procedure name 

FUNC Function name 

ARRAY Array name 

The software prints the symbol value after the symbol type. For a variable, the value is the value ot the 
variable. For a procedure name, a function name, or an array name, the value is the host memory 
address of the procedure, function, or array, respectively. 
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5.7.7 DISPLAY LOAD MODULE SYMBOL TABLE COMMAND. The Display Load Module 
Symbol Table command (MSYM) displays a list of all load module symbols, the symbol types, and 
the symbol values. The display includes a count of the symbols also. The syntax for the command 
is as follows : 


?MYSM; 


The AMPL software prints one of the following symbol types after each symbol: 


IDT 

DEF 

REF 


Module identifier 
External definition 
Unresolved external reference 


The software prints the symbol value after the symbol type. For the module identifier, the value 
is the target system memory address into which the module was loaded. For an external definition, 
the value is the target system memory address corresponding to the defined symbol. For an un- 
resolved external reference, the value is either the most-recently assigned value, or the initial 
value, if no value has been assigned. The initial value is the target system memory address of the 
last location of a linked list of addresses into which the reference should be loaded. 

The following is an example of the MSYM command showing the resulting display: 

?MSYM; 


MAIN 

IDT 

>0100 

START 

DEF 

>0120 

BUFF 

DEF 

>0430 

5.7.8 DELETE 

LOAD 

MODULE SYMBOL TABLE COMMAND. The Delete 


The syntax for the command is as follows: 

7MDEL; 

It is possible to load a module without deleting the load module symbols of a previously loaded module 
by using the OFF option in the LOAD command. The user may clear the load module symbol table 
without clearing the other symbol tables by entering this command. 

The following is an example of the MDEL command followed by an MSYM command: 

7MDEL; 

7MSYM; 

0 ENTRIES IN TABLE 

5.7.9 DISPLAY SYSTEM SYMBOL TABLE COMMAND. The Display System Symbol Table 
command (SSYM) displays a list of system symbols, the symbol types, and the symbol values. The 
display includes a count of the symbols, also. The syntax for the command is as follows: 

7SSYM; 
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The AM PL software prints one of the following symbol types after each symbol: 


VAR 

PROC 

FUNC 

ARRAY 


Variable 
Procedure name 
Function name 
Array name 


The software prints the symbol value after the symbol type. For a variable, the value is the value of the 
variable. For a procedure name, a function name, or an array name, the value is the host memory 
address of the procedure, function, or array, respectively. 


5.7,10 SAVE TEST ENVIRONMENT COMMAND. The Save Test Environment command 
(SAVE) stores the test environment and a program from specified locations in target system memory 
on a specified file. The test environment includes a user symbol table, and user procedures and 
functions. Optionally, the command also stores the specified entry point. The syntax for the SAVE 
command is as follows: 


?SAVE(‘<access name>’[,<start>,<end>[,<entry>] ] ) 

The access name is a character string that contains the name of the file on which the test environment 
and program are to be stored. The name of the file is a name that is acceptable to the operating system; 
e.g., a TX990 file name, or a DX10 pathname or synonym. When the file does not exist, AM PL 
software creates the file. When the file contains data, the test environment and program replaces the 
previous contents of the file. The start operand is the address of the first word to be stored, and the end 
operand is the address of the last word to be stored. The entry operand is the address of the entry 
point of the stored program. When the start and end operands are omitted, the program is not 
saved; only the test environment is saved. When the entry operand is omitted, the RSTR command 
does not alter the contents of the program counter. The file written by the SAVE command may 
be read by the RSTR command to restore a test environment and a target system program to 
resume a test. 

The test environment stored by a SAVE command consists of currently defined user symbols, current 
default format specifications, user procedures, and user functions. No device assignments or device 
status are stored. The following is an example of a SAVE command using a TX990 file name: 

?SAVE ( 1 :MYDBUG/SAV' ,>FE00,>FE46 ,>FE26) Store test environment on file 

DSC:M YDBUG SAV. Also store the 
contents of target memory starting at 
address FEOOu, and ending at address 
FE46ia and store FE26 k, as the entry 
point. 

The following is an example of a SAVE command using a DX10 file name: 

^SAVE ( 1 VAMPL,SAV,MYDBUG,>FE00,>FE46,>FE26) Store test environment 

on file VAMPL.SAV. 
MYBUG. Also store the 
contents of target memory 
starting at address FE00 16 
and ending at address 
FE40 16 , and store FE26 16 
as the entry point. 
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5.7.11 CLEAR TEST ENVIRONMENT COMMAND. The Clear Test Environment command 
(CLR) clears the test environment, and optionally reserves space fora user symbol table fora specified 
number of symbols. The syntax for the CLR command is as follows: 

?CLR [(<symbols>)] 

The CLR command deletes all user symbols, user procedures, and user functions. The optional 
symbols operand is an expression having a positive integer value (greater than zero) which is the 
number of user symbols that may be defined in the user symbol table. A CLR command allows 
redefining a test environment. Following a SAVE command, a CLR command prepares the working 
storage for the start of another test. The user may change the size of the user symbol table with the 
optional operand. Unless a previous CLR command has changed the symbol table, the capacity of the 
user symbol table is 30 symbols. The user may reduce the size to provide more memory space for 
procedures and functions if few symbols are required. The user may increase the size to allow more 
symbols to be defined. In deciding how large the table should be, the user should notice that LOAD 
commands define module names as user symbols, PROC and FUNC statements define procedure and 
function names that are placed in the table, and assign statements define user symbols unless the 
symbol has previously been defined. 

When a CLR command is entered in a compound statement, and the statement executed, completion 
of execution of the CLR command terminates the compound statement. Any statements within the 
compound statement following the CLR statement are not executed. 

The following is an example of a CLR command: 

?CLR (19) Clear the user symbol table, and delete 

any user procedures and functions. 
Provide a user symbol table having a 
capacity of 19 user symbols. 

5.7.12 RESTORE TEST ENVIRONMENT COMMAND. The Restore Test Environment command 
(RSTR) restores the test environment in the host computer memory and a program in target system 
memory. The test environment and program are obtained from a file written by a SAVE command. 
When the SAVE command included an entry point operand, the RSTR command places the entry 
point in the target system program counter. The following is the syntax for the RSTR command: 

?RSTR(‘<access name>’) 

The access name is a character string that contains a TX990 file name, or a DX10 pathname or 
synonym. When the RSTR command completes, the user symbol table, user procedures, and user 
functions are in the host computer memory in the state stored by the SAVE command, and the 
program defined in the SAVE command has been loaded into target system memory. Device 
assignments made in CNSL, LIST, or COPY commands prior to the RSTR command remain in 
effect. 

When an RSTR command is entered in a compound statement and the statement is executed, 
completion of execution of the RSTR command terminates the compound statement. Any statements 
within the compound statement following the RSTR command are not executed. 
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It is possible for there to be more than one TX990 operating system in which the AMPL program 
executes; systems in which the program occupies different locations in memory. The SAVE and RSI R 
commands use absolute memory addresses. An RSTR command will not correctly restore the test 
environment when the SAVE command is executed by the AMPL program in different areas of 
memory. 

In a DX10 system, memory mapping allows the system to place the AMPL program anywhere in 
memory, and the restriction of the SAVE and RSTR commands to the same system environment 
does not apply. However, the memory size parameter (paragraph 5.2.2) in effect when the RSTR 
command is executed must be large enough to accommodate the data stored by the SAVE 
command. 

The following is am example of a RSTR command using a TX990 file name: 

7RSTR ( 1 :MYDBUG/SAV' ) Restore lab test environment and program 

at point at which file DSC:MYDBUG/SAV 
was written. 

The following is an example of an RSTR command using a DX10 pathname: 

? RSTR ( VAMPL . SAV. MYDBUG) Restore lab test environment and 

program at point at which file 
VAMPL.SAV. MYDBUG was written. 

5.7.13 ENTER TEXT EDITOR COMMAND. The Enter Text Editor command (EDIT) saves the 
test environment and terminates the AMPL program. The command also activates the Text Editor, 
and returns control to the AMPL program at the end of the editing operation. Then the command 
restores the stored test environment and resumes the test. The command is supported only in a TX990 
system. The following is the syntax for the EDIT command: 

?EDIT [(‘<access name>’)] 

The access name is a character string that contains the name of a file. The operand is a TX990 file name 
of the file to be edited. When the access name is omitted, the file name is DSC:AMPL000/ PRC. 

The command stores the test environment on file DSC:AMPL000/'SAV and transfers control to the 
program in a file named DSC:TXEDIT/ SYS or DSC2:TXEDIT/ SYS (on floppy disk unit 1 or 2, 
respectively). The parameters passed to TXEDIT are the file name (the operand of the command) or 
DSC: AM PL000/ PRC as the file to be edited, file DSC:AMPL000/SCR as the scratch file, and M9000 
as the memory size parameter. This allows about 150 lines of code in the editor’s buffer. When editing is 
terminated, the data entered is in the scratch file. TXEDIT displays the message: 

TEXT IN SCRATCH FILE 
TRANSFER TO INPUT? 

The user should enter a Y for yes to transfer the data to the file named in the EDIT command or to file 
DSC:AM PL000 PRC. If the user enters N for no, the data may only be accessed on file 
DSC: AM PL000 SCR, where it will be replaced during the next editing performed with an EDIT 
command. Control transfers to the program in file DSC:AMPL/SYS (on the left hand floppy disk 
unit), and the environment is restored from file DSC: AMPL000/ SAV. 

If the transfer to TXEDIT or back is unsuccessful, the system displays the following message: 
BATCH ABORTED 
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The user may reactivate AM PL and enter a RSTR command that specifies file DSC:AMPL000/SAV 
to recover from the error. 

The following are examples of EDIT commands: 

? EDIT; Edit file DSC: AMPL000/ PRC. Invalid in 

a DX10 system. 

7 EDIT (‘DSC2:MYPROJ/PRC’) Edit file DSC2:MYPROJ/ PRC. Invalid 

in a DX10 system. 

5.7.14 COPY INPUT COMMAND. The Copy Input command (COPY) changes the input source to 
a specified file or device. The AM PL software reads commands and statements from the specified file 
or device until it reads an end-of-file, then resumes input from the system console. The syntax for the 
COPY command is as follows: 

7COPY [(‘<access name>’)] 

The access name is a character string that contains the name of a file or device. The name of the file or 
device is a name that is acceptable to the operating system; e.g., a TX990file or device name, ora DX10 
device name or file pathname or synonym. When the operand is omitted in a TX990 system, the COPY 
command copies the most recently edited file (edited by the Text Editor during execution of an EDIT 
command). When an EDIT command has not been executed since the AMPL program was activated, 
an error message is issued. The operand is required in a DX10 system. 

When commands and statements are read as specified in a COPY command, they are not displayed on 
the system console. When a LIST command is in effect, they are written to the list device or file. 

A copy file may contain a COPY command that transfers the input to another device or file. This 
provides chaining, rather than nesting; reading of statements from a file continues until either another 
COPY statement or an end-of-file is read. When an end-of-file is read, the system console resumes 
input. Any statements or commands that follow a COPY command on a copy file or in a compound 
statement are not executed. There is no limit to the number of copy files that may be chained in this 
way. 


The following is an example of a COPY command using a TX990 file name: 

7COPY (‘:AMPLFN/CPY’) Execute the commands and statements 

on file DSC:AMPLFN/CPY and return 
input to the system console at end-of-file. 

The following is an example of a COPY command using a DX10 pathname: 


7COPY ('VAMPL.CPY.AMPLFN’) Execute the commands and statements on 

file VAMPL.CPY.AMPLFN and return 
input to the AMPL terminal at end-of- 
file. 


5.7.15 DELETE COMMAND. The Delete command (DELE) deletes the specified user procedure, 
function, or array from host memory. The syntax for the DELE command is as follows: 

7DELE(‘<name>\[‘<name>’]. . . ) 
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1 he operands are character strings that contain the names of user procedures, functions, or arrays to be 
deleted. Deleting a procedure, function, or array makes its memory space available for redefinition of 
the same procedure, function, or array, or for other purposes. 


Executing a DELE command does not delete the name in the user symbol table. The name of a deleted 
procedure may only be used in a PROC statement as a procedure name, and the name of a deleted 
function may only be used ina EUNC statement as a function name. The name of a deleted array may 
only be used inan ARRAY statement as the name of an array wit h the same number of dimensions. To 
make these names available for other purposes, the user must execute a CLR command to clear the 
symbol table. 

The following is an example of a DELE command: 

']_ DELE (‘7 I M EN\ ‘M EMTST’, ‘NU M’) Delete procedure T1MEN, function 

MEMTST, and array NUM. 

5.7.16 DELAY AMPL EXECUTION COMMAND. The Delay AM PL Execution command 
( W All ) delays execution of AM PL software for a specified number of 50 ms periods. The syntax of 
the WAIT command is as follows: 

J?WAIT(<number>) 

The operand is an expression that specifies the number of 50 ms periods of delay. During the delay 
period, execution of AM PL software is suspended. At the end of the delay period the AM PL software 
resumes execution and displays a question mark to request another command or statement. An 
operand of 20 provides a delay of one second. The WAIT command is useful when displaying data on 
the screen of a VDT. When displaying data continuously the data may not remain on the screen long 
enough to be read by the user. The user may place a W AIT command following each display statement 
to provide enough time to read the display. The WAIT command is not affected by pressing the key 
that terminates execution of other commands as described in paragraph 5.3. 

The following is an example of a WAIT command: 

? WAIT(200) Delay 10 seconds. 

2 . . TEN SECONDS LATER 

5.7.17 OUTPL1T NEW LINE COMMAND. The Output New Line command (NL) outputs a carriage 
return and line feed to the system console and supplementary listing device, when a suppiementarv 
listing device is active. The following is the syntax for the NL command: 

?NL; 

No operand is required. The NL command is intended for use in a procedure, function, or compound 
statement. It is equivalent to a display statement using the N format specification and displaying 
spaces. The following is an example of an NL command: 

? NL; 

5.7.18 VERIFY COMMAND. The Verify command (VRFY) verifies a program in target system 
memory by comparing the contents of the specified file with the contents of memory starting at the 
specified bias address. The software prints the contents of the addresses that do not contain the values 
in the file. The syntax for a VRFY command is as follows: 

?VRFY(‘<access name>[,<bias>]) 
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The access name is a character string that contains a TX990 file name, or a DXIO pathname or 
synonym. The bias operand is the address in memory at which the program to be verified was loaded. 
When the specified file contains an absolute program, the software ignores the bias operand. When the 
file contains a relocatable program and the bias operand is omitted, the default value of A0,„ is used. 

The VRFY command prints the address, file contents, and memory contents of every address that 
contains data different from that in the file. The command may be used to verify the loading of a 
program, or to identify locations within a program that have been altered from the values loaded. Data 
areas that are reserved by the program using directives such as BSS and BSE cannot be verified with 
the VRFY command. When the contents of every address agree with the contents of the file, no 
message is printed. 

The following is an example of a VRFY command using a TX990 file name and the messages that 
identify locations that have been altered: 

1.VRFY ( ' DSC:SINTST/0BJ ' ,>1000) Verify contents of locations loaded from 
>0114 / >0000 >000E file DSC:SINTST,/OBJ at location 1000 16 

>01 5A / >0000 >3C00 

>01 5C / >0000 >6ED8 

>01 5E / >0000 >4004 


The following is an example of a VRFY command using a DX10 pathname: 

— VRFY( VAMPL . OBJ . SINTST 1 ) Verify contents of locations loaded from 

file VAMPL.OBJ. SINTST at location 
1 00 1 6 - Absence of a message indicates that 
no location was altered. 

5.7.19 TERMINATE AMPL PROGRAM COMMAND. The Terminate AMPL Program 
command (EXIT) terminates the program and returns control to the operating system. The syntax for 
the EXIT command is as follows: 

?E XI T ('<access name>' ,<start>,<end> ,<entry> ) 

The operands apply only to DX10; if they are entered for TX990, they are ignored. The access name is a 
character string that contains the pathname of synonym of a file on which the test environment and 
program are to be stored. When the file does not exist, AMPL software creates the file. When the file 
contains data, the test environment and program replaces the previous contents of the file. The start 
operand is the address of the first word of target system memory to be stored, and the end operand is 
the address of the last word to be stored. The entry operand is the address of the entry point of the 
stored program. When the EXIT command is entered without operands, the AMPL program 
terminates. When the operands are included (in a DX10 system), the program performs a SAVE 
command, assigns the access name operand as the value of synonym $AMPL$E, and terminates. 
Refer to paragraph 5.7.10 for the effect of omitting the start and end operands or the entry 
operand. The use of a synonym allows the AMPL SCI command (which activates the AMPL 
program) to obtain the pathname of the save file and restore the environment and program when 
the AMPL program is next activated. Use of synonym $AMPL$E for any other purpose, assigning 
another value to it, or deteting it will prevent proper restoration of the test environment when the 
AMPL program is next activated. 
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To resume execution of the AM PL program before loading another program into host memory (when 
executing under TX990), it is not necessary to load the program again. The following is an example of 
an EXIT command followed by the entry that restarts the program: 

7EXIT; Terminate the AMPL program. 

PROGRAM: >10* Restart the AMPL program. 

When another program has been loaded into host system memory, the AMPL Program must be 
restarted as follows (under TX990): 

PROGRAM: :AMPL/SYS* 

When executing under DX 10, perform the procedure in paragraph 5.2.2 beginning at step 20 to 
restart the AMPL program. When the EXIT command specified a save file, a start address, and 
an end address, the test environment and program are restored as the AMPL program begins 
execution. If synonym $AMPL$E has been altered, the results are unpredictable. 

The following is an example of an EXIT command with operands supported by DX10: 

7EXIT ( 'VAMPL.SAV.MYDBUG' ,>FE00,>FE46,>FE26) Terminate the AMPL pro- 
gram, storing the test 
environment on file 
VAMPL.SAV.MYDBUG. 

Also store the contents of 
target memory at address 
FE00 16 and ending at ad- 
dress FE46 16 , and store 
FE26 16 as the entry point. 

The capability of storing the test environment with an EXIT command provides a capability under 
DX10 similar to that of the EDIT command under TX990. After the execution of the EXIT command, 
the user may activate the Text Editor to write or edit a file. When the user restarts the AM PL program, 
the program resumes at the point at which the EXIT command was executed. 

5.8 CRU COMMANDS 

AM PL software supports two sets of CRU commands. One set, CRUR and CRU W, reads from and 
writes to a CRU device of the target system. System variable CRU B contains the CRU base address for 
the read and write operations. The other set, HCRR and HCRW, reads from and writes to a CRU 
device of the host system. System variable HCRB contains the CRU base address for the read and 
write operations for the host system. 

The user may check out any device on the CRU interface of the target system using CRUR and 
CRUW. When the target system is a controller or similar device that interfaces with a Model 990 
Computer via the CRU interface, it can be connected to the host system, and HCRR and HCRW can 
be used to verify the CRU interface. 

5.8.1 CRU READ COMMAND. The CRU Read command (CRUR) is a system function that reads a 
specified number of bits from a specified address in the target system CRU. System variable CRUB 
contains the CRU base address and the command returns the value right-justified in a 16-bit word. The 
syntax for the command is as follows: 

?CRUR(<displacement>,<length>) 
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The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit read is displaced from the base address in 
system variable CRUB. The length operand is an expression having a positive integer value in the range 
of 1 through 16, which represents the number of bits to be read. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then reads the number of bits specified by the length operand, and 
returns the value right-justified in a 16-bit word. 

The following is an example of assigning a base address value and a CRUR command: 

?CRUB = >0100 Assign value of 100i6 as CRU base 

address. 

7CRUR (8,8) Read 8 bits from target system CRU at 

address derived from base address of 100i6 
plus 1 0 1 6 (CRU address 88, 6 ). 

Alternatively, the command and its operands may be used as an expression in an AM PL statement. 
The value of the expression is the data read from the target system CRU. The following is an example 
of a CRUR command used in this way, assuming that CRUB remains unaltered from the preceding 
example: 

2CRUOUT = CRUR (0,8) Read 8 bits from target system CRU and 

assign the value to user symbol CROUT. 

The CRU address is derived from CRU 
base address 100i6 (CRU address 80i6). 

5.8.2 CRU WRITE COMMAND. The CRU Write command (CRU W) writes a specified value into a 
specified number of bits of the target system CRU at a specified address. System variable CRUB 
contains the CRU base address. The following is the syntax for the command: 

7CRU W(<displacement>,<length>,<value>) 

The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit written is displaced from the base address 
in system variable CRUB. The length operand is an expression having a positive integer value in the 
range of 1 through 16, which represents the number of bits to be written. The value operand is an 
expression, the value of which is written. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then writes the number of bits specified by the value of the length 
operand. The rightmost bits of the value operand are written to the CRU. The following is an example 
of the CRU W command, which assumes that CRUB remains unaltered from the preceding example: 

7CRUW (16,4,>A) Write the value 10 10 2 into the target 

system CRU at address derived from base 
address of 100i6 plus 20i6 (CRU address 
90,5). 

5.8.3 HOST CRU READ COMMAND. The Host CRU Read command (HCRR) is a system 
function that reads a specified number of bits from a specified address in the host system CRU. System 
variable HCRB contains the CRU base address and the command returns the value right-justified in a 
16-bit word. The syntax for the command is as follows: 

?HCRR(<displacement>,<length» 
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The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit read is displaced from the base address in 
system variable HCRB. The length operand is an expression having a positive integer value in the 
range of 1 through 16, which represents the number of bits to be read. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then reads the number of bits specified by the length operand, and 
returns the value right-justified in a 16-bit word. 

The following is an example of assigning a base value and an HCRR command: 

7HCRB = >0200 Assign value of 200 i 6 as CRU base 

address. 

7HCRR(0,8) Read 8 bits from host system CRU at 

address derived from base address of 200it, 
plus 0 (CRU address lOOi*). 

Alternatively, the command and its operands may be used as an expression in an AM PL statement. 
The value of the expression is the data read from the host system CRU. The following is an example of 
an HCRR command used in this way, assuming that HCRB remains unaltered from the preceding 
example: 

7NUCHAR = HCRR(16,8) Read 8 bits from target system CRU and 

assign the value to user symbol 
NUCHAR. The CRU address is derived 
from the base address of 200u plus 20i 6 
(CRU address 110 16 ). 

5.8.4 HOST CRU WRITE COMMAND. The Host CRU Write command (HCRW) writes a 
specified value into a specified number of bits of the host system CRU at a specified address. System 
variable HCRB contains the CRU base address. The following is the syntax for the command: 

?HCRW(<displacement>,<length>,<value>) 

The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit written is displaced from the base address 
in system variable HCRB. The length operand is an expression having a positive integer value in the 
range of 1 through 16, which represents the number of bits to be written. The value operand is an 
expression, the value of which is written. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then writes the number of bits specified by the value of the length 
operand. The rightmost bits of the value operand are written to the CRU. The following is an example 
of the CRU W command, which assumes that HCRB remains unaltered from the preceding example: 

7HCRW (8,8,“BC”) Write the ASCII representation of C into 

the host system CRU at the address 
derived from base address of 200i6 plus 
1 0 1 6 (CRU address 108 i 6 ). 
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CAUTION 

Use extreme care that the CRU base address in HCRB is correct before 
executing an HCRW command. If an HCRW command is executed 
with a value in HCRB that causes the command to address one or more 
lines to the host system peripheral devices, normal operation of the 
system is impaired. 

5.9 DATA INPUT COMMANDS 

The AM PL software supports reading a file of data into host or target memory. The file may be 
prepared using the Text Editor, and must contain valid AM PL expressions separated by spaces. The 
expressions in the file may contain variables and/or constants separated by arithmetic operators + and 
- only. The Data Input commands are OPEN, READ, and CLSE. Another command, EOF, also 
applies to read operations. 

5.9.1 OPEN COMMAND. The OPEN command specifies the device to be used for data input. The 
syntax for the OPEN command is as follows: 

?OPEN(‘<access name>’) 

1 he operand is a character string that contains a pathname (as defined for the operating system) of a 
data file or a device name of a data input device. An OPEN command must be executed prior to 
wading data from a file or device other than the AMPL terminal or if reading is to be resumed from a 
file or device other than the AMPL terminal after a Close operation. 

The following are examples of OPEN commands using TX990 file and device names: 

? OPEN(‘:INPUT/ DAT') Open file TNPUT/DAT for data input. 

2 0PEN(‘ASR’) Open 733 ASR terminal (not system 

console) for data input. System console 
does not require entry of an OPEN 
command. 

The following are examples of OPEN commands using DX10 pathnames and device names: 

? OPEN(‘VAM PL. DAT. INPUT’) Open file VAMPL.DAT.INPUT for data 

input. 

1 OPEN(‘ST09’) Open terminal other than AMPL terminal 

for data input. AMPL terminal does not 
require entry of an OPEN command. 

5.9.2 READ COMMAND. The READ command is a system function that returns the value of the 
next expression from the data input file or device specified in the current OPEN command, or from the 
AMPL terminal if an OPEN command is not in effect. The syntax for the READ command is as 
follows: 

? READ; 
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The READ command may be entered as an AMPL statement to display the value of an expression 
read from a file or device. Each record may contain only one expression. The typical use of the 
command is in an assign statement, to assign the value of the expression to a variable or to a target 
system location. The following are examples of assign statements using READ commands: 

/?DATIN = READ; Assign the next constant in the file to 

DATIN. 

^@(START+48) = READ; Assign the next constant in the file to 

target system memory location START 
+48. 

When a READ command is executed with no OPEN command in effect (either no OPEN command 
has been entered or a CLSE command has been entered since the most recent OPEN command), the 
software requests the user to enter an expression as follows: 


I he user enters an expression followed by a carriage return. The expression must be either a constant, a 
variable, or a series of constants and/or variables connected by arithmetic operator + or -. Other 
operators are invalid and result in an error message. Spaces may be entered as desired. The following 
are examples of expressions that may be entered: 

_+? >23CO The value of the expression is 23C0i6. 

MYVAR + 0A0 The value of the expression is the sum of 

the value of variable MYVAR plus A0i 6 . 

=? MYVAR - 4 The value of the expression is the 

difference of the value of variable 
MYVAR minus 4. 

When an OPEN command specifies a terminal and a READ command is entered, the AMPL program 
does not display an equal sign and a question mark as in the preceding examples. The user may enter 
expressions in the same manner as if the prompt had been displayed. 

5.9.3 EOF COMMAND. The EOF command is a system function that returns the state of the end-of- 
file flag for the file or device. The syntax for the command is as follows: 

7EOF; 

The EOF command performs a read operation to obtain the current state of the flag, and returns a 
nonzero value (true) when end-of-file has been set, or a zero value (false) when end-of-file has not been 
set. A subsequent READ command returns the data read in the read operation performed by an EOF 
command. When a READ command follows one or more EOF commands in the order of execution, 
the READ command returns the value obtained by the immediately preceding EOF command; when 
more than one EOF command is executed prior to a READ command, data is lost. 

The following is an example of the EOF command used in an IF statement: 

?I FfeSNOT|6EOF|6THEN|ziDATA = READ 
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5.9.4 CLOSE COMMAND. The Close command (CLSE) terminates data input. The syntax for the 
CLSE command is as follows: 

7CLSE; 

A CLSE command may be used to terminate data input from a file or device in order to open a different 
file or device for data input. The user may close a file and then open the file in order to rewind the file 
and input the data again. 

5.10 EMULATOR OPERATION COMMANDS 

The emulator replaces the microprocessor of the target system and provides the interface between the 
host system and the target system. This interface allows the host system to: 

• Start the microprocessor 

• Stop the microprocessor 

• Display the current status of the emulator 

• Stop the microprocessor on an external signal 

• Stop the microprocessor when it accesses a specified address 

• Stop the microprocessor when it writes into a specified address 

• Stop the microprocessor when it executes the instruction at a specified address 

• Store a specified number of memory addresses accessed and stop the microprocessor when 
the addresses have all been stored 

• Store a specified number of addresses of instructions executed and stop the microprocessor 
when the addresses have all been stored 

• Substitute trace memory for the 512 high-order addresses of target system memory 

• Substitute user memory for target system memory, addresses 0000i 6 through 1 FFFi 6 . 

The host computer communicates with the emulator through the CRU to control the emulator and 
ultimately the target system. AM PL software supports the following commands to control the 
emulator: 

• Initialize Emulator (E1NT) 

• Define Breakpoint Conditions (EBRK) 

• Select Event (EEVT) 

• Initialize Compare Logic (ECMP) 

• Initialize Trace Logic (ETRC) 

• Start Microprocessor (ERUN) 
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• Stop Microprocessor (EHLT) 

• Read Trace Memory (ETB) 


There are several system variables that relate to emulator operation. Where a system variable relates 
directly to a command, the variable is discussed with the command. System variables ETM and EU M 
control the mapping of the target system memory, and relate to all target system operations. These 
variables may be displayed or changed. The following are examples of displaying ETM and EUM: 


?ETM:B 

<g)00g00ggOQ®g)0001 


?EUM:B 

<0000000000000001 


Display system variable ETM in binary 
mode. Value of 1 indicates that target 
system memory addresses FEOOis through 
FFFF 16 (TMS 9900) or 3E00i6 through 
3FFF|6 (TMS 9980) are mapped into 
Emulator trace memory (figure 4-1). 

Display system variable EUM in binary- 
mode. Value of 1 indicates that target 
system memory addresses 0 through 
IFFF 16 are mapped into Emulator user 
memory (figure 4-1). 


To change the values of ETM and EUM to zero, mapping all target system memory addresses into 
target system memory, use assign statements as follows: 


?ETM — 0 Set system variable ETM to zero. 

?EUM=0 Set system variable EUM to zero. 

System variable EMT identifies the type of microprocessor being emulated. This variable may be 
displayed and tested, but may not be altered by the user. System variable EMT has a value of zero when 
a TMS 9980 buffer is connected to the emulator, and a value of one when a TMS 9900 buffer is 
connected to the emulator. The following are examples of the use of system variable EMT: 


? EMT : B1 

1 


1 IF EMT THEN 'TMS 9900' ELSE 
TMS 9980 


Display the value of system variable 
EMT. The result indicates that a 
TMS 9900 microprocessor is being 
emulated. 

'TMS 9980' 

Display message appropriate to type of 
microprocessor being emulated. 


5.10.1 INITIALIZE EMULATOR COMMAND. The Initialize Emulator command (E1NT) selects 
and initializes an emulator to execute subsequent emulator control commands. The syntax for the 
command is as follows: 


?EINT(‘<device name>’) 

The operand is the device name assigned during system generation. In the TX990 system supplied by 
Texas Instruments, the device name is EMU. For a DX10 system, the device name is EM01 (for the 
first emulator). The E1NT command must be entered prior to accessing target memory. Once the 
command has been entered, it need not be entered again unless the AM PL program is reloaded or 
unless there is more than one emulator in the system. When there is more than one emulator, an EINT 
command must be entered prior to using a different emulator. 
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The following are examples of E1NT commands using TX990 device names: 

^ElNTf'EMU’) Initialize EMU as the active emulator. 

^EINT(‘EMU2’) Initialize EMU2 as the active emulator. 

The following are examples of EINT commands using DX10 device names: 

9 EINT(‘EM0U) Initialize EM01 as the active emulator. 

■9 EINT(‘EM02’) Initialize EM02 as the active emulator. 

5.10.2 DEFINE BREAKPOINT CONDITIONS COMMAND. The Define Breakpoint Conditions 
command (EBRK) defines the conditions for breakpoints, and the action the emulator takes when a 
breakpoint occurs. The syntax for the command is as follows: 


?EBRK[( 


( 




) 




EVT 
FULL 

)EVT+FULL( 
OFF 







The first operand specifies breakpoint conditions. When this operand is the keyword EVT, a 
breakpoint occurs on an event as defined by the EEVT command. When the operand is the keyword 
FULL, a breakpoint occurs when a specified number of trace addresses have been stored or when the 
trace memory overflows. When the breakpoint condition operand is the keyword EVT+FULL, a 
breakpoint occurs either when an event occurs or when the specified number of trace addresses have 
been stored. When the operand is the keyword OFF, no breakpoint occurs. 

The second operand specifies breakpoint action. When the operand is the keyword SELF, a 
breakpoint consists of stopping the microprocessor (target system) at the completion of the currently 
executing instruction. When the operand is the keyword OFF, a breakpoint consists of sending a 
breakpoint signal to the trace module and incrementing the count in system variable ENI without 
stopping the microprocessor. When the breakpoint action operand is omitted, whichever keyword was 
entered most recently in an EBRK command remains in effect. 

The EBRK command may be entered with no operands to display the breakpoint conditions and 
action in effect. When this is done prior to entering an EBRK command with one or more operands, 
the initial breakpoint conditions and action are displayed, as follows: 

7EBRK; 

+OFF +QFF 

±DFF 

This indicates that the two breakpoint conditions are off and that the breakpoint action is also off. The 
first keyword on the first line is either -FEVT or +OFF, and means that the breakpoint on an event is on 
or off, respectively. The second keyword on that line is either -FFULL or TOFF, and means that the 
breakpoint on completion of a trace operation is either on or off, respectively. The keyword on the 
second line is either SELF or OFF and means that the breakpoint action of stopping the 
microprocessor is either on or off, respectively. 
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The following are examples of EBRK commands: 


2 EBRK(EVT) 

? EBRK(FULL) 

? EBRK(EVT+FULL) 
? EBRK(OFF) 


? EBRK(EVT,SELF) 


Enable breakpoint on event only. The 
event is defined by an EEVT command. 
Breakpoint action remains unchanged. 

Enable breakpoint on completion of trace 
only. Breakpoint action remains 
unchanged. 

Enable breakpoint on event or on 
completion of trace. Breakpoint action 
remains unchanged. 

Disable all breakpoints. Breakpoint 
action (which would apply by default in a 
subsequent EBRK command) remains 
unaltered. 

Stop the microprocessor when an event 
occurs. 


1 EBRK(EULL,OFF) Breakpoint on trace completion. 

Breakpoint results in signal to trace 
module and is counted, but does not stop 
the target system. 


5.10,2.1 System Variable ENI. System variable ENI maintains a count of emulator interrupts. An 
emulator interrupt occurs at each breakpoint while the breakpoint action operand is set to OFF. The 
count is set to zero when the target system is started. The user may display the contents of ENI, but may 
not assign a value to this variable. The following is an example of a display of ENI: 

i ENED Display the value of system variable ENI. 


5.10.3 SELECT EVENT COMMAND. The Select Event command (EEVT) selects the event for 
breakpoints. The syntax for the EEVT command is as follows: 


lEEVU ({’$>] 

When the user enters the keyword 1NT, the event that causes a breakpoint is the internal comparison 
circuitry of the emulator. When the user enters the keyword EXT, an external signal is the event that 
causes the breakpoint. The signal is connected to a terminal (P7) on the emulator module. 

The user may enter an EEVT command with no operand to display the event selection in effect. When 
this is done prior to entering an EEVT command with an operand, the initial event selection is 
displayed as follows: 

?EEVT; 

TINT 


This indicates that the internal comparison circuitry of the emulator triggers a breakpoint. When the 
keyword EXT is displayed, the external breakpoint signal triggers a breakpoint. 
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When the EVT keyword of the EBRK command is in effect, an EEVT command that specifies key- 
word EXT sets up a breakpoint on the external signal. When the external signal connected to P7 
goes low the breakpoint is effective. An EEVT command that specifies keyword INT sets up a 
breakpoint on an internal comparison defined in an ECMP command. 


The following are examples of EEVT commands: 


? EEVT (INT) Select internal comparison signal as event. 

? EEVT (EXT) Select external signal as event. 

5.10.4 INITIALIZE COMPARE LOGIC COMMAND. The Initialize Compare Logic command 
(ECMP) initializes the emulator comparison logic to compare a specified type of address to a specified 
address. The syntax for the ECMP command is as follows: 


?ECMP[( 


S ADDR 
[ADDR]-DBINl 
[ADDR+]IAQ 
OFF 


[,<address>])] 


The first operand is the address type (qualifier) operand. When this operand is the keyword ADDR, all 
addresses on the address bus (for read, write, or instruction acquisition accesses) are compared to a 
specified value. When the operand is the keyword ADDR-DBIN the address on the address bus is 
compared only when DBIN is false (write cycles only). When the address type operand is the keyword 
ADDR+IAQ, the address on the address bus is compared only when I AQ (Instruction Acquisition) is 
true (program counter address). When the operand is the keyword OFF, comparison is inhibited. 


The second operand, the address operand, is the value to which the address bus value is compared. 
When the target system uses a TMS 9900 microprocessor, the second operand may be any value in the 
range of 0 through FFFFi 6 . When the target system uses a TMS 9980 microprocessor the range of 
valid addresses is 0 through 3 FFFi 6 . No event can occur if the second operand is greater than 3FFF t6 . 


The second operand has no significance when the first operand is the keyword OFF. When the address 
operand is omitted, the address in the most recent ECMP command is used in the comparison. The 
user may enter an ECMP command with no operands to display the address type and address value in 
effect. When this is done prior to entering an ECMP command with operands, the initial address type 
and value are displayed as follows: 


? ECMP; 

OFF 

>0000 

This indicates that the comparison logic is disabled and that the address operand is 0. The keyword on 
the first line may be any of the four keywords used as the address type operand and identifies the type of 
address being compared. The second line displays the current address operand. 

For the comparison specified in an ECMP command to result in a breakpoint, an EEVT command 
must set event to INT and an EBRK command must set the breakpoint condition to EVT or to 
EVT+FULL. 
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The following are examples of ECMP commands: 
? ECMP (ADDR,>FF46) 

? ECMP (-DB1N,>FF00) 

? ECMP (IAQ) 


Compare addresses of all memory 
accesses to FF46| 6 . 

Compare addresses of all write memory 
accesses to FFOOia. 

Compare addresses of all instruction 
acquisition memory accesses to the most 
recently entered address operand ( FFOO 16 , 
if the preceding example is the most 
recently entered ECMP command). 


? ECMP (OFF) 


Inhibit comparison. 


5.10.5 INITIALIZE TRACE LOGIC COMMAND. The Initialize Trace Logic command (ETRC) 
specifies the type of address to be stored, the number of addresses to be stored, and the clock for storing 
the addresses. The syntax for the ETRC command is as follows: 


1ETRC 


! ADDR ) l T NT) 

[ADDR+] IAQ | [,<count> [.{ E x T }]] )1 


The first operand specifies the type of addresses to be stored. When the operand is the keyword 
ADDR, all addresses on the address bus (for read, write or instruction acquisition accesses) are stored. 
When the operand is the keyword ADDR+I AQ or the keyword IAQ, addresses on the address bus are 
stored only when IAQ (Instruction Acquisition) is true (program counter addresses). When the address 
type operand is the keyword OFF, no addresses are stored. 

The second operand is the count operand, which may be any valid expression having a value in the 
range ot 1 through 256. The count operand has meaning only when an EBRK. command with a 
condition operand of FULL or EVT+FULL and an action operand of SELF is in effect. Under these 
conditions, the count operand specifies the number of values to be stored during the trace operation. 
When breakpoint conditions and action is effect do not halt the target system, addresses are stored 
until the target system is halted in some other manner, overwriting previously stored addresses when 
the 256-word trace memory becomes full. When the count operand is omitted, the most recently 
entered count operand applies. 

The third operand selects the clock enable signal for storing the addresses. When the operand is the 
keyword INT. the operation is clocked by the internal target system clock. When the operand is the 
keyword EXT, the trace operation is clocked by an external enable signal, normally from the trace 
module. When the clock operand is omitted, the most recent clock selection applies. 

A trace operation consists of storing the specified type of addresses. When the breakpoint condition in 
effect is either FULL or EVT+FULL and the breakpoint action in effect is SELF, the operation 
completes a breakpoint occurs when the number of addresses specified as the count has been stored. 
The stored data is accessible using the ETB command. The data is stored in the trace memory of the 
emulator module. System variable ETM should be set to zero during a trace operation. If ETM is set to 
one and if the target system accesses one or more addresses above FEOO 16 , interference between the 
target system and the trace operation occurs. 
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Whenever tracing is enabled, addresses are stored in trace memory. When the breakpoint action 
operand of the EBRK command in effect is OFF, completion of a trace operation or overflow of trace 
memory does not halt the target system. If the target system runs long enough, all 256 words of trace 
memory will have been filled with stored addresses when the target system halts. The trace memory 
contains up to 256 traced addresses or the most recently stored 256 traced addresses when it is halted. 

The user may enter an ETRC command with no operands to display the address type, count, and clock 
operands in effect. When this is done prior to entering an ETRC command with operands, the initial 
address type, count, and clock are displayed as follows: 

7ETRC; 

OFF 

256 

TINT 


This indicates that the trace logic is disabled, the trace count is set to 256, and the trace is internally 
clocked. The keyword on the first line may be any of the three keywords used as the address type 
operand and identifies the type of addresses traced. The value on the second line is the count of 
addresses to be traced. The keyword on the third line is either TINT or TEXT, and indicates internal or 
external clock, respectively. 

The following are examples of ETRC commands: 

? ETRC (ADDR, 10,INT) Trace ten addresses, storing an address at 

each memory access using internal clock. 

? ETRC (OFF) Turn trace off. 

In using the ETRC command in a TMS 9980 system the count operand may be odd, but an even 
number of addresses is always traced. This is because the TMS 9980 accesses two bytes for each word 
accessed, and tracing does not stop until the currently executing instruction completes execution. The 
following example traces one address in a TMS 9900 system, and two addresses in a TMS 9980 
system: 

2 ETRC (I AQ, 1 ,INT) Trace one instruction, storing an address 

at each memory access of the instruction 
word. If the FULL and SELF options of 
the EBRK command are in effect, this 
results in execution of a single instruction 
each time the microprocessor is started. 

In a TMS 9900 system, emulator trace memory contains the instruction address at the completion of 
the trace operation. In a TMS 9980 system, emulator trace memory contains the addresses of both 
bytes of the instruction (or of the first word of the instruction). Storing of the address of the even byte 
can be inhibited when the emulator and trace modules are set up to trace simultaneously, the clock 
operand of the ETRC command is EXT, and the trace module is set up to trace only when the address is 
odd. paragraph 5.9.5 describes the TTRC command for setting up tracing in the trace module. 
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5.10.6 START MICROPROCESSOR COMMAND. The Start Microprocessor command (ERUN) 
clears the Hold signal to the emulator, starting the microprocessor. Execution begins at the address in 
system variable PC, with the target system workspace pointer set to the value in system variable WP 
and the target system status register set to the value in system variable ST. The syntax for the command 
is as follows: 


7ERUN; 


In many cases, a program would have been loaded into the target system memory. If an entry point 
were not specified in the source code, the user would assign the entry address to variable PC. Similarly, 
system variables WP and ST are set to the required values. The user could define a breakpoint usingan 
EBRK command, and EEVT command, and an EC MP command. Alternatively, the user could define 
a breakpoint on completion of a trace operation using an EBRK command and an ETRC command, 
or define both breakpoints. Or the user may allow the program to execute to its normal termination or 
stop it with an EHLT command. 

The following is an example of a set of statements and commands to load and execute a program 
consisting of a single instruction: 


2@>100 = > 10FF 
7PC = >100 
7WP = >200 
2ST = 0 
7ERUN 


Single instruction loop into address 1 00 1 6 . 
Set PC. 

Set WP. 

Set ST. 

Start target system. 


5.10.6.1 System Variable EST. The software maintains the current status of the emulator in system 
variable EST. The user may display the value of EST at any time, but may not assign a value to this 
variable. The following is an example of a display of EST: 


? EST; 

EST - >0005 


Display status of emulator in system 
variable EST. Result indicates that the 
target system is running and that the event 
logic has generated a breakpoint. 


The status value is returned in the least significant digit, as shown in table 5-1. System variable EST 
may also be used with a mask value to test for a specific status condition, as in the following example: 

_? I Ft6EST|6ANDfc5T 0THEN{zS 'EMULATOR IS RUNNING' Print message if least significant 

bit of system variable EST is true. 


A mask value of I tests the status bit that is true when the emulator is running. A mask value of 2 tests 
the status bit that is true when a trace overflow breakpoint has occurred. A mask value of 4 tests the 
status bit that is true when an event breakpoint has occurred. A mask value of 8 tests the status bit that 
is true when an Idle instruction is being executed. 


5.10.7 STOP MICROPROCESSOR COMMAND. The Stop Microprocessor command (EHLT) 
sends the Hold signal to the emulator, halting the microprocessor. The syntax for the EHLT command 
is as follows: 


7F.HLT; 
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Contents of 
Least Significant Digit 
of System Variable EST 
(Hexadecimal) 

0 


1 


2 

3 


4 


Table 5-1 . Emulator Status 


Status 

Target system is halted. Neither an event or trace overflow 
has caused a breakpoint. 

Target system is running and is not executing an Idle in- 
struction. Neither an event or trace overflow has caused a 
breakpoint. 

Target system is halted, a trace overflow breakpoint has 
occurred, and an event breakpoint has not occurred. 

Target system is running and is not executing an Idle in- 
struction. A trace overflow breakpoint has occurred and 
an event breakpoint has not occurred. 

Target system is halted. An event breakpoint has oc- 
curred, and a trace overflow breakpoint has not occurred. 


5 


6 

7 


9 


B 


D 


F 


Target system is running and is not executing an Idle in- 
struction. An event breakpoint has occurred, and a trace 
overflow breakpoint has not occurred. 

Target system is halted and both an event and a trace 
overflow breakpoint have occurred. 

Target system is running and is not executing an Idle in- 
struction. Both an event and a trace overflow break- 
point have occurred. 

Target system is running, executing an Idle instruction. 
Neither an event or trace overflow has caused a break- 
point. 

Target system is running, executing an Idle instruction. 
A trace overflow breakpoint has occurred, and an event 
breakpoint has not occurred. 

Target system is running, executing an Idle instruction. 
An event breakpoint has occurred, and a trace overflow 
breakpoint has not occurred. 

Target system is running, executing an Idle instruction. 
Both an event and a trace overflow breakpoint have oc- 
curred. 
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When an expected breakpoint is never reached, or when no breakpoint is in effect, the microprocessor 
may be stopped by executing an EHLT command. The command displays the emulator status (system 
variable EST). Since the status is read after the microprocessor is halted, only the even numbers in 
table 5-1 apply. The following is an example of an EHLT command: 

? EHLT Halt the microprocessor. The displayed 

>0002 status indicates that the target system is 

halted, an event breakpoint has not 
occurred, and a trace o verflow breakpoint 
has occurred. 

5.10.8 READ TRACE MEMORY COMMAND. The Read Trace Memory command (ETB) is a 
system function that reads the specified value from the emulator trace memory. The syntax for the 
command is as follows: 

?ETB(<index>) 

The index operand may be any valid expression. When the value of the expression is a valid index to 
the emulator trace memory, the command prints the value stored in the word corresponding to the 
index value. The limits of valid index values can be determined by displaying the values of two system 
variables. System variable ETBN contains the index value corresponding to the most recently stored 
word. ETBN contains 0 at the completion of a trace operation. System variable ETBO contains the 
index value corresponding to the first word stored (oldest word). 

The emulator stores values in trace memory when tracing is initialized by an ETRC command, and the 
target system is started. The last value stored during the trace operation is accessible using an index 
value of 0. The values stored prior to the completion of the trace operation are accessed using negative 
index values, with the most negative index value corresponding to the value first stored. 

TMS 9900 addresses are 16-bit addresses, and occupy all 16 bits of the trace memory words. TMS 9980 
addresses are 14-bit addresses; the trace memory stores these addresses in the least significant 14 bits of 
trace memory words, with zeros in the two most significant bits. The TMS 9980 accesses two bytes for 
each word accessed by the TMS 9900. Unless the trace module is used to inhibit tracing both addresses, 
the trace memory in the emulator contains an even and an odd address for each word accessed. 

Alternatively, an ETB command and its operand may be used as a variable in an expression in an 
AMPL statement. The value stored in trace memory corresponding to the value of the operand 
becomes the value of the command when used as a variable. 

The user should enter an ETB command immediately following the trace operation. If an ERUN 
command is entered following the trace operation and before the ETB command, traced values will be 
lost unless the trace is turned off before starting the microprocessor. Also, if system variable ETM is set 
to one following the trace, and if an ERUN command is entered, contents of the trace memory may be 
altered if the microprocessor accesses target system memory addresses FE00 )6 through FFFF, 6 
(TMS 9900) or 3E00i 6 through 3 FFFi 6 , 7E00 i6 through 7FFF 16 . BE00 16 through BFFF 16 . or 
FE00 16 through FFFF 16 (TMS 9980). 
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The following are examples of ETB commands: 

? ETB (0) 

>1056 


? ETB (-1) 

>1054 


Display the most recently stored address. 

Display the address stored prior to the 
address displayed in the preceding 
example. 


The following is an example of a series of AMPL statements that use the ETB command as a variable: 

]_ N = ETBO Initialize variable N to the index of the 

]_ WHILEj&N0LE0ETBN0DO0BEGIN oldest item stored. Display the stored 

12 ETB(N):HN value and increment N. Perform display 

11 N = N+l until all traced values have been displayed. 

1? END 


When the user enters an index value greater than the value of ETBN or less than the value of ETBO, the 
software prints an error message. 

S.10.8.1 System Variable ETBO. System variable ETBO is set to the index value of the oldest value 
stored in memory by the emulator module. ETBO may not be assigned a value by the user, but may be 
displayed whenever the emulator is not running. The value of ETBO is the smallest (most negative) 
value that may be used as an index in an ETB command. When this value is 1 and the value of ETBN is 
0. no values have been stored and an ETB command cannot be executed. The following is an example 
of a display statement to display ETBO: 

Display the index to the oldest address 
stored in emulator trace memory. 


I ETBO 
ETBO >FFFE 


5.10.8.2 System Variable ETBN. System variable ETBN is set to the index value of the most recently 
stored value in memory by the emulator module. ETBN may not be assigned a value by the user, but 
may be displayed whenever the emulator is not running. The value of ETBN is zero, the largest (most 
positive) value that may be used as an index in an ETB command. The following is an example of a 
display statement to display ETBN: 


? ETBN 
ETBN= >0000 


Display the index to the newest address 
stored in emulator trace memory. 


5.11 TRACE MODULE OPERATION COMMANDS 

The trace module stores and analyzes up to 256 20-bit values under control of the host computer and 
optionally in conjunction with the emulator module. The clock used for storing and analyzing traced 
values may be either an internal 1 0 MHz clock or an external clock up to 1 0 MHz. Four qualifiers may 
be used to select a clock as a trigger for storing and analyzing a value. Analyzing a value consists of 
comparing selected bits of the value to corresponding bits of a value stored in a comparison register. 

The trace module may be connected in any of three modes as shown in figure 5-1. In the stand-alone 
mode, the data cable with probe leads is connected to the trace module and no control cable is 
connected. This allows tracing of up to 20 logic signals to which probe leads are connected, under 
control of up to four qualifiers (logic signals to which other probe leads are connected). Two additional 
probe leads may be connected to an external clock and an external event signal. 
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STANDALONE MODE 
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EMULATOR CONTROL - EXTERNAL DATA MODE 
I 1 DATA CABLE 
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CONTROL CABLE 


EMULATOR 


(A) 136543 


EMULATOR CONTROL AND DATA MODE 
Figure 5-1. Trace Module Connections 
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In the emulator control-external data mode, the data cable with probe leads is connected to the trace 
module to provide data and control input as in the stand-alone mode. A control cable connects the 
trace module to the emulator module to synchronize tracing. In this mode, tracing does not begin until 
the target system is started by the emulator, and the trace module may request the emulator to halt the 
target system at the completion of the current instruction. 

In the emulator control and data mode, both the input data cable and the control cable connect the 
trace module to the emulator module. This allows tracing of either memory addresses or memory data 
using qualifiers and external clock from the emulator module. When the target system uses a 
TMS 9900 microprocessor, only three qualifiers are used. When the target system uses a TMS 9980 
microprocessor, all four qualifiers are used. The qualifiers are connected to the following emulator 
signals: 

• The inversion of the least significant address bit, true when an even address is on the address 
bus (TMS 9980); true at all times (TMS 9900). 

• Instruction Acquisition (IAQ), true during a memory cycle that reads an instruction from 
memory. 

• Data Bus In (DBIN), true during memory read cycles. 

• Emulator Event (EMU), true during memory cycles in which comparison logic in the 
emulator indicates an equal comparison. 

When the data cable connects the trace module to the emulator module, the external event signal is 
connected to the emulator event signal in the emulator, and the external clock signal is connected to the 
emulator clock. 

In the stand-alone mode, operation of the trace module begins when a Start Trace command is 
executed. Otherwise, tracing begins when the target system is started following execution of a Start 
Trace command. 

The input data is stored on each selected clock. When the breakpoint is defined, tracing may be stopped 
at the occurrence of a breakpoint. Otherwise, the user may stop tracing by executing a Stop Trace 
command, or the emulator may halt the trace module (except in the stand-alone mode). Storing of data 
continues until the module halts, overlaying previously stored data after 256 values have been stored. 
Thus, when the module halts, the trace memory contains the 256 most recently stored values. 

When the trace module is connected in the emulator control and data mode, either addresses or data 
may be stored in the trace module. When the target system uses a TMS 9900 microprocessor, the 
addresses and the data are both 16-bit words. When the target system uses a TMS 9980 
microprocessor, the address is a 14-bit address and the data is accessed in 8-bit bytes. The 14-bit 
address is placed on the address bus in the 14 least significant bits and the two most significant bits are 
at logic zero. The 8-bit data bytes are combined to form a 16-bit word under control of the least 
significant bit of the address. On an even address (least significant bit equals zero) the 8 data bits are 
placed in the most significant half of the data bus. On an odd address (least significant bit equals one) 
the 8 data bits are placed in the least significant half of the data bus, and the most significant half retains 
its previous contents. Thus during memory accesses at even addresses the data bus only contains the 
most significant half of the word. During memory accesses at odd addresses the data bus contains the 
word at the next lower even address. 

A trace operation may be defined in terms of a number of values to be stored, and a breakpoint may be 
specified to occur when the trace operation completes. 
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I he comparison logic ol the trace module coni pares selected hits ol the data being stored with the data 
in the comparison register. An event occurs w hen the result ol the comparison is equal. Alternativ ely. 
an external signal identifies an event. I he trace module contains both an event counter and a delay 
counter, each of w hich is set to a value supplied by the usei. I he event counter decrements when an 
event occurs. When the event counter counts down to zero, the delay counter begins decrementing each 
time a value is stored in trace memory. When the delay count reaches zero, the event and delay 
completion occurs, which may optionally cause a breakpoint. 

When a breakpoint occurs at completion of a trace operation or ol an event and delay, the trace module 
may interrupt the host computer without stopping the trace or requesting the emulator to stop. 
Optionally, the breakpoint may interrupt the host computer and stop the trace but not request the 
emulator to stop. Another option is that of requesting the emulator to stop the target system at 
completion of the currently executing instruction without interrupting the host computer. Tracing 
continues until the emulator stops the target system in this case. A fourth option requests the emulator 
to stop the target system at completion of the currently executing instruction and also stops the trace. 
Only the first two options apply to the stand-alone mode. 

When tracing is stopped by the emulator following a request from the trace module, it is possible for as 
many as eight memory clock cycles to occur in the emulator between the time the request is issued and 
the time the trace stops. If the trace module is following the emulator clock, there could be eight values 
stored during this time depending on the qualifiers specified. When the trace module is internally 
clocked, the number of values stored during this time is a function of the emulator clock period, the 
qualifiers, and the currently executing instruction. When the sum of the number of additional clock 
cycles plus the specified delay exceeds 255, the trace memory is filled with values stored after the last 
event and previously stored values are lost. 

The host computer communicates with the trace module through the CRU to define the addresses and 
options for the trace. The AMPL software supports the following commands to control the trace 
module: 

• Initialize Trace Module (TINT) 

• Define Trace Breakpoints (TBRK) 

• Select Trace Event (TEVT) 

• Initialize Trace Compare Logic (TCMP) 

• Initialize Trace Module Trace Logic (TTRC) 

• Start Trace (TRUN) 

• Stop Trace ( I HLT) 

• Read Low Order Trace Module Memory (IT B) 

• Read High Order Trace Module Memory (TTBH) 
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5.11.1 INITIALIZE TRACE MODULE COMMAND. The Initialize Trace Module command 
(TINT) selects and initializes a trace module to execute subsequent trace module control commands. 
The syntax for the command is as follows: 

?TI NT ( '<device name>‘ ) 

T he operand is the device name assigned during system generation. In the TX990 system supplied by 
T exas Instruments the device name is TRA. For a DX 10 system, the device name is T MO I (for the first 
trace module). Once the command has been entered it need not be entered again unless the AM PL 
program is reloaded or unless there is more than one trace module in the system. When there is more 
than one trace module, a TINT command must be entered prior to using a different trace module. 

The following are examples of TINT commands using TX990 device names: 

Initialize T RA as the active trace module. 

Initialize TRA2 as the active trace 
module. 

The following are examples of TINT commands using DX10 device names: 

? TINT(TMOl’) Initialize TM01 as the active trace 

module. 

?TINI(TM02) Initialize TM02 as the active trace 

module. 


?TINT( 'TRA' ) 
?TINT('TRA2') 


5.11.2 DEFINE TRACE BREAKPOINT COMMAND. The Deline Trace Breakpoint command 
O BRK) defines the conditions that cause a breakpoint and the action that the breakpoint causes. The 
syntax for the TBRK command is as follows: 


?TBRK[( 


! EVT ) ( SELF ) 

FULL ( f ) EMU 

EVT+FULL( L, )SELF+EMU( JjJ 
OFF J ( OFF ) 


The first operand specifies breakpoint conditions. When the keyword EVT is entered, a breakpoint 
consists of an event and delay completion. When the keyword FU LL is entered, a breakpoint consists 
of a trace completion. When the keyword EVT+FULL isentered.a breakpoint may beeitheranevent 
and delay completion or a trace completion. When the keyword OFF is entered, neither completion 
causes a breakpoint. 

I he second operand specifies a breakpoint action. When the keyword SELF is entered, a breakpoint 
causes the trace operation to stop and an interrupt to be sent to the host computer. When the keyword 
EMU is entered, a breakpoint causes the trace module to request the emulator to halt at the completion 
of the currently executing instruction. When the keyw ord SELF+EMU is entered, a breakpoint causes 
the trace operation to stop and requests the emulator to halt at the completion of the currently 
exeeuting instruction. When the keyword OFF is entered, a breakpoint causes the trace module to 
interrupt the host computer. When the breakpoint action operand is omitted, the most recently entered 
breakpoint action operand of a TBRK command continues to apply. 
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All four keywords that may be used as the breakpoint condition operand apply to all connection 
modes. However, when the keyword OFF is entered and the trace module is connected in the stand- 
alone mode, a 1 H 1. 1 command must be entered to stop the trace. When the keyword OFF' is entered in 
either of the other connection modes, tracing stops whenever the emulator stops. When the FVT or 
FVT+FUFF keyword is entered, this command operates in conjunction with a TEVT and TCMP 
command to breakpoint alter a specified delay following a specified event. When the FULL or 
LV1 + FULL keyword is entered, this command operates in conjunction with a TTRC command to 
breakpoint when a specified number of values have been stored in trace memory. System variable TN E 
(described in a subsequent paragraph) maintains a count of events. 

Keywords EMU and SELF+EMU are not relevant as the breakpoint action operand in the stand- 
alone connection mode. All breakpoint action keywords are relevant in the other two connection 
modes. When keywords EMU and SEEF+EMIJ are used, a breakpoint causes the trace module to 
request the emulator to halt the target system. Unless the SEEF keyword of an EBRK command is in 
effect as the breakpoint action operation for the emulator, the emulator will not halt the target system. 
When the OFF keyword has been entered, the trace module interrupts the host computer when a 
breakpoint occurs. 

I he I BRK command may be entered with no operands to display the breakpoint conditions and 
action in effect. When this is done prior to entering a TBR K command with one or more operands, the 
initial breakpoint conditions and action are displayed, as follows: 

2 TBR K; 

+OFF +OFF 

+OFF +OFF 


I his indicates that the two breakpoint conditions are off, and the two breakpoint actions are off. The 
first keyword on the first line is either +EV T or +OFF and means that an event and delay completion 
breakpoint is on or off, respectively. The second keyword on that line is either + FU EL or +OFF, and 
means that the breakpoint on completion of a trace is either on or of f, respectively. The first keyw ord 
on the second line is either +SELF or +OFF. and means that the stop trace breakpoint action is either 
on or off. respectively. The second keyword on the second line is either +EMU or TOFF, and means 
that the send request to emulator breakpoint action is either on or off, respectively. 

The following are examples of 1 BRK commands: 


? EBRK (FVT-FF TJLF.SELF+EMU) 


? TBR K (FULL) 


? I BRK (I VI, Of F) 


2 I BRK (OFF) 


Define a breakpoint to occur on 

completion of an event and delay or of a 
trace operation, and to stop the trace 
operation immediately and request the 
emulator to stop at completion of the 
current instruction. 

Define a breakpoint to occur on 

completion of a trace operation only. 
Breakpoint action is that defined in 
prev ious command. 

Def ine breakpoint to occur on completion 
of an event and delay operation only, and 
to interrupt the host computer without 
stopping the trace. 

Inhibit breakpoints. 
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5.11.2.1 System Variable TNE. System variable TNE is set to zero when the trace is started, and 
counts events. TNE may not be assigned a value by the user, but may be displayed whenever the trace 
module is not running. The following is an example of a display statement to display TNE: 

]_ TNE Display the count of events that have 

>0004 occurred since the most recent TRUN 

command. 

Counting of events is independent of the count specified for a breakpoint, and does not stop until the 
trace stops. When a delay is specified, events that occur during the delay period cause the final event 
count to exceed the count specified as a breakpoint. The count is maintained as an unsigned number. 

5.11.2.2 System Variable TNI. System variable TNI is set to zero when the trace is started, and counts 
interrupts. TNI may not be assigned a value by the user, but may be displayed at any time. The 
following is an example of a display statement to display TNI: 

Display the count of interrupts that have 
occurred since the most recent TRUN 
command. 

The count in system variable TNI is maintained as an unsigned number. 

5.1 1 .3 SELECT TRACE EVENT COMMAND. The Select Trace Event command (TE VT) selects an 
event by specifying an event count, a delay count, and the event mode. The syntax for the TEVT 
command is as follows: 


1 TNI 
>0010 


?TEVT[(<events>[,<delays>[,|^°5 M J + [edge] + [eXt] 3])] 

The first operand specifies the number of events. The operand may be any valid expression having a 
value of zero through 65,535 to be placed in the event counter. Since the maximum positive value that 
can be expressed as a decimal number is 32,767, values greater than this must be entered as 
hexadecimal, octal, or binary values. A value of zero provides an event count of 65,536. 

An event may be the equal comparison result of an internal comparison specified in a TCMP 
command (paragraph 5.9.4) or an external signal to which the EVENT probe lead is connected, 
determined by the mode operand described in a subsequent paragraph. The user specifies a number of 
events to be counted before initiating the delay period. Thus the first event or a specific subsequent 
event is the first condition for a potential breakpoint. 

The second operand provides the delay value. It may be any expression having a value of zero through 
255 to be placed in the delay counter. When the delay operand is omitted, the most recently entered 
delay operand continues to apply. 

The delay count specifies a number of items to be traced after the event count has been satisfied. The 
potential breakpoint occurs after the specified items have been traced. The user specifies a delay to 
obtain a trace of desired items immediately following the event. 
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The third operand selects the event mode. The operand consists of a single keyword, the sum of two 
keywords, or the sum of three keywords. Keyword NORM specifies decrementing the event counter 
when the selected event signal is true. Keyword INV specifies decrementing the counter on a false 
signal. When neither NORM nor IN V is specified, a true signal decrements the count. Keyword EACH 
specifies decrementing the counter at each selected event signal. Keyword EDGE specifies 
decrementing the counter only when the specified value of the specified event signal is different from 
the value at the previous clock. When neither EACH nor EDGE is specified, the count is decremented 
at each signal. Keyword INT selects the equal comparison result of the internal comparison logic as the 
event. Keyword EXT selects the external event signal as the event. In the stand-alone and emulator 
control (external data connection modes), the external event signal is connected by the user to an 
appropriate logic signal. In the emulator control and data connection mode, the external event is the 
emulator event signal. When neither INT or EXT is specified, the internal event is selected. When the 
entire operand is omitted, the most recently entered event mode operand continues to apply. 


The TEVT command may be entered with no operands to display the event count, delay count, and 
event mode in effect. When this is done prior to entering a TEVT command with one or more operands, 
the initial event count, delay count, and event mode are displayed, as follows: 

? TEVT; 

I 

I) 

+NORM+EACH+1NT 

This indicates that the event count is one, the delay count is zero, and the internal event signal true 
constitutes an event at each clock. The event count is displayed on the first line and the delay count is 
displayed on the second line. The event mode is displayed on the third line. Table 5-2 shows the eight 
possible modes and the meaning of each. 

The operands of a TEVT command specify a potential breakpoint after a delay specified as a number 
of trace memory stores following an event that satisfies the event count. 


The third operand defines the conditions for an event. A TBRK command that specifies EVT or 
EVT+FULL must be in effect for an actual breakpoint to occur. 

The following are examples of TEVT commands: 


? TEVT (0,0,NORM+EACH+INT) 

l TEVT (1) 

? TEVT (5,35) 

? TEVT (>8E4F) 


Count at each selected clock when the 
internal comparison signal is true. Event 
and delay completion occurs with no 
delay after the 65,536th event. 

Alter event count to 1, leaving previously 
entered delay and mode unaltered. 

Alter event count to 5 and delay count to 
35 leaving previously entered mode 
unaltered. 

Alter event count to 8E4F| 6 (36431) 
leaving previously entered delay and 
mode unchanged. 
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Table 5-2. Event Modes 

Event Mode 

Meaning 

+NORM+EACH+INT 

Decrement at each selected clock during which the internal event 
signal is true. 

+NORM+EACH+EXT 

Decrement at each selected clock during which the external event 
signal is true. 

+NORM+EDGE+INT 

Decrement at selected clock when the internal event signal has 
changed from false to true since the preceding selected clock. 

+NORM+EDGE+EXT 

Decrement at selected clock when the external event signal has 
changed from false to true since the preceding clock. 

+INV+EACH+INT 

Decrement at each selected clock during which the internal event 
signal is false. 

+INV+EACH+EXT 

Decrement at each selected clock during which the external event 
signal is false. 

+INV+EDGE+INT 

Decrement at selected clock when the internal event signal has 
changed from true to false since the preceding selected clock. 

+INV+EDGE+EXT 

Decrement at selected clock when the external event signal has 


changed from true to false since the preceding selected clock. 


Note: A selected clock is a clock signal selected for storing a value in trace memory. Specified 
qualifiers in specified states select a clock pulse. 


5.11.4 INITIALIZE TRACE COMPARE LOGIC COMMAND. The Initialize Trace Compare 
Logic command (TCMP) specifies values to be placed in the comparison register and in the compare 
mask register. The syntax for the TCMP command is as follows: 


?TCMP [( 


ADDR 

DATA 



,<low 16 value>[,<low 16 mask>]])] 


The first operand specifies the mask and values for the high-order four bits of the compare register, and 
optionally, the source of data to be compared. Optionally, the keyword ADDR or the keyword DATA 
may be entered, specifying the type of data being supplied to the trace module in the emulator control 
and data mode. The remainder of the operand is a series of one to four keywords to specify the mask 
and values of the high-order bits. Keywords Q0 through Q3 denote the high order bits, with QO the 
most significant bit. When a plus sign precedes a keyword, the corresponding bit in the compare 
register is set to one. When a minus sign precedes a keyword, the corresponding bit in the compare 
register is set to zero. The sign may be omitted preceding the first keyword; the plus sign applies. When 
the keyword corresponding to a bit is omitted, that bit is masked off and does not participate in the 
comparison. When the keyword OFF is entered, neither data source is specified, all four bits are 
masked off and the four high-order bits of the compare register do not participate in the comparison. 
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When the target system uses a TMS 9980 microprocessor and keyword DATA is entered, the 
appropriate state of keyword Q0 should be specified also. When DATA+QO is entered, an equal 
comparison is possible only when an even memory address is being accessed. The data bus at this time 
contains the byte at the even address in the most significant eight bits and random data in the least 
significant eight bits. When DATA-QO is entered, an equal comparison is possible only when an odd 
memory address is being accessed. The data bus at this time contains the two bytes of a memory word, 
with the even-addressed byte in the most significant eight bits and the odd-addressed byte in the least 
significant eight bits. Thus when emulating a TMS 9980 and comparing to data, DATA-QO should be 
entered to avoid undesired equal comparisons. 

The second operand is the value to be placed in the low-order 16 bits of the compare register. The 
operand may be any valid expression. When the second operand is omitted, the most recently entered 
value continues to apply. 

The third operand is the value to be placed in the low-order 16 bits of the compare mask register. The 
operand may be any valid expression. 

When the target system uses a TMS 9980 microprocessor the mask value can be used to select the valid 
bits. When the ADDR keyword is entered, the TMS 9980 address is in the 141east significant bits with 
the two most significant bits set to zero. By using a mask operand less than 4000i 6 , the user specifies a 
comparison that ignores the two most significant bits and compares only valid address bits. 

One bits in the mask register correspond to bits that are compared. When the third operand is omitted, 
the most recently entered value is the low-order 16 bits of the compare mask register continue to apply. 

In the emulator control and data connection mode, the four high-order bits of the data word and the 
four qualifiers are common. When the target system uses a TMS 9900 microprocessor, Q0 and the 
high-order bit are connected to logic one. When the target system uses a TMS 9980 microprocessor, 
Q0 and the high-order bit are connected to the inversion of the least significant address bit. Q 1 , Q2, and 
Q3 are connected to 1AQ, DB1N, and EM. EVENT, respectively. Table 5-3 lists alternate keywords 
that may be used in the first operand. When the trace module is connected in this manner, the first 
operand of the TCMP command must contain a subset of the qualifiers specified in the TTRC 
command. Otherwise, the comparison always fails because the comparison is made to qualified values. 


Table 5-3. Alternate Keywords for Qualifiers 


Keyword 

Connected To 

Alternate Keyword 

Q0 

Logic one (TMS 9900) 
Inversion of A13 (TMS 9980) 

None 

Ql 

Instruction Acquisition 

1AQ 

Q2 

Data Bus In 

DBIN 

Q3 

Emulator Event 

EMU 
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In the emulator control and data connection mode, the data input is supplied by the emulator. When 
an ETRC command with either the keyword IAQ or the keyword ADDR is in effect, the emulator 
supplies memory data to the trace module. When an ETRC command with the keyword OFF is in 
effect, the emulator may supply either memory data or memory addresses to the trace module, as 
specified by the TTRC command. Keywords ADDR and DATA in the TCMP command are checked 
for compatibility with the current ETRC and TTRC commands. 

In the stand-alone or emulator control external data connection mode, the four most significant bits of 
the data word and the four qualifiers are separate probe leads and are connected by the user as the test 
requires. 

The TCMP command specifies an event to provide an event and delay breakpoint as defined in a 
TE VT command that specifies INT in the event mode. A TBRK command that specifies either EVT or 
EVT+FULL must be in effect for the breakpoint to occur. 

The TCMP command may be entered with no operands to display the compare register and compare 
mask register contents in effect. When this is done prior to entering a TCMP command with on or 
more operands, the initial compare register contents and compare mask register contents are 
displayed, as follows: 

? TCMP; 

OFF 

>FFFF 

+0000 

This indicates that the high-order four bits are masked off, the low-order 16 bits of the compare register 
contain FFFFi 6 , and no low-order bits are compared. The first line is either OFF or is some 
combination of keywords DO through D3, in which DO through D3 specify the high-order four bits of 
the compare and compare mask registers. The signs and the omission of a keyword have the same 
significance as in the first operand of the command. The second line shows the contents of the 16 low- 
order bits of the compare register. The third line shows the contents of the 16 low-order bits of the 
compare mask register. 

The following are examples of TCMP commands: 

?TCMP (Q0+Q1+Q2+Q3),>4142,>FFFF) Set the comparison mask to compare all 

20 bits, comparing to F4142i6. 

Set the comparison mask to compare only 
bit 1 and the bits not masked off by the low 
16 mask operand in effect. Compare data 
to 2FE0i6 and IAQ true. (Emulator 
control and data mode.) 

Set the comparison mask to ignore all four 
high order bits, and compare the low 
order 16 bits to the most recently entered 
compare value and mask value. 


? TCMP (IAQ,>2FE0) 


? TCMP (OFF) 
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ICMP (I)ATA-Q0+IAQ,>1 0FF.>FFFF) Compare instruction data on data bus to 

IOFFh, (JMP $ instruction) when the 
entire word has been accessed and placed 
on the data bus ( TMS 9980). If addresses 
are being stored in emulator trace memory 
simultaneously, the stored address is an 
odd address, one greater than the address 
of the instruction. 


5.11.5 INITIALIZE TRACE MODULE TRACE LOGIC COMMAND. The Initialize Trace 
Module Trace Logic command (TTRC) specifies the qualifiers, count, and clock for a trace operation. 
The TTRC command also enables or disables the pulse-latching function. Optionally, the TTRC 
command initializes the emulator module to provide the specified input data. The syntax for the 
command is as follows: 



count>[,{^}t,g F }]]])] 


The first operand specifies the mask and values for the qualifiers that select the clock for the trace 
operation, and optionally, the source of data to be traced. When the keyword ADDR is entered as the 
optional word, the memory address bus of the target system is selected for tracing. When the keyword 
DATA is entered, the memory data bus is selected. The remainder of the operand is a series of one to 
four keywords to specify the mask and values of the qualifiers. Keywords Q0 through Q3 denote the 
qualifiers, with Q0 the most significant qualifier bit. When a plus sign precedes the keyword, the 
corresponding bit in the qualifier register is set to one. When a minus sign precedes the keyword, the 
corresponding bit in the qualifier register is set to zero. The sign may be omitted preceding the first 
keyword; the plus sign applies. When the keyword corresponding to a bit is mitted, that bit is masked 
off and is not used as a qualifier. When the keyword corresponding to a bit is omitted, that bit is 
masked off and is not used as a qualifier. When the keyword OFF is entered, neither data source is 
specified, all four qualifiers are masked off and tracing occurs on every clock. 

The second operand specifies the number of values to be stored during the trace operation. The 
operand may be any valid expression having a value in the range of 1 through 256. The second 
operand is ignored unless the first operand of the TBRK in effect is either FULL or EVT+FULL 
and the second operand of that command is SELF, EMU, or EMU + FULL. When the second 
operand is omitted, the most recently entered value continues to apply. 


The third operand selects the clock source for the trace operation. When the keyword 1NT is entered, 
the internal clock is the clock for the trace operation. When the key word EXT is entered, the external 
clock is the clock for the trace operation. When neither keyword is entered, the most recent clock 
selection continues to apply. 


4 he fourth operand controls the latch mode of the trace module. When the keyword OFF is entered, 
the latch mode is disabled. When the ON is entered, the latch mode is enabled. When neither keyword 
is entered, the most recent latch mode keyword continues to apply. 

The choice of DATA or ADDR in the first operand applies only in the emulator control and data 
mode. When either keyword is entered, AMPL software verifies that the data cable is connected to the 
emulator. If an ETRC command with the keyword OFF is in effect, the software issues the necessary 
control signal to the emulator to provide the specified data. Otherwise, the software verifies that the 
specified data is being supplied by the emulator. When the cable is not connected, or when the other 
type ol data has been selected by an ETRC command, the software prints a warning message. 
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The qualifiers specified in the first operand must all be in the specified state at clock time in order to 
select a clock for storing a traced value. When the trace module is connected in the emulator control 
and data mode, the qualifiers are connected as shown in table 5-3, and the alternate keywords may be 
used in the first operand. 

When the target system uses the TMS 9980 microprocessor, and the keyword DATA is specified, 
entering -Q0 as a qualifier results in more efficient use of the trace memory. The data stored in trace 
memory when qualifier -Q0 is in effect consists of words that contain the bytes in the proper order. If 
qualifier +Q0 is entered, the most significant byte of the addressed word is stored with random data in 
the least significant byte. If the qualifier Q0 is omitted, two words are stored for each word in memory; 
the first word contains the most significant byte of the addressed word with random data in the least 
significant byte, and the second word contains the complete word. 

The count operand is used to determine the completion of the trace operation (trace full condition). 
The count is placed in the trace buffer counter, which is decremented as values are stored. When the 
counter is at one and the memory stores a value, the trace full signal occurs which causes a breakpoint if 
a TBRK command that specifies FULL or EVT+FULL is in effect. 

The clock operand selects the clock for the trace operation. The internal clock is a 1 0 MHz clock in the 
trace module. In the stand-alone and emulator control-external data modes, external clock is the signal 
: o which the probe lead designated CLOCK is connected. In the emulator control and data mode, the 
external clock is the emulator end-of-memory cycle clock. 

The latch operand enables or disables the latch mode. The four most significant lines of data are 
equipped to latch narrow data pulses when the latch mode is enabled. They function like the other 16 
lines when the latch mode is disabled. In the emulator control and data mode, the lines that are 
equipped with latches are connected to the same signals as the qualifiers. 

The TTRC command may be entered with no operands to display the qualifiers, count, clock, and 
latch in effect. When this is done prior to entering a TTRC command with one or more operands, the 
initial qualifiers, count, clock, and latch are displayed, as follows: 

l TTRC; 

OFF 

256 

+ INT 
+0FF 


This indicates that the qualifiers are masked off, and that the trace count is 256. Internal clock is to be 
used, and the latch mode is disabled. The first line is either OFF or some combination of the keywords 
used in the first operand. The secon dline displays the count in effect. The third line is either 1NT or 
EXT, corresponding to internal or external clock, respectively. The fourth line is either ON or OFF, 
indicating that the latch mode is enabled or disabled. 


The following are examples of TTRC commands: 


? TTRC (Q0-Q1 -Q2+Q3, 1 28, 1 NT, OFF) 


Trace 128 values that occur when 
qualifiers 0 and 3 are true and qualifiers 1 
and 2 are false, using the internal clock. 
Set latch mode OFF. 
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- TTRC (DATA-DB1N) Set to trace memory data written during 

write accesses using previously entered 
additional operands (emulator control 
and data mode). 

2 TTRC (OFF,25,INT,ON) Trace 25 values on internal clock, ignoring 

qualifiers with latch mode. 

? TTRC (DATA-QO.256.EXT.OFF) Trace data words in trace memory, using 

external clock with latch inhibited. 
Generate the trace memory full signal 
when 256 words have been stored. Store 
when the entire memory word is on the 
data bus (TMS 9980). 

5.11.6 START TRACE COMMAND. The Start Trace command (TRUN) enables the trace 
operation. The syntax for the TRUN command is as follows: 

? TRUN, Start the trace module. 

In the stand-alone connection mode, the trace module starts when the TRUN command is executed. In 
the emulator control external data mode or emulator control and data mode, the trace module starts 
when a TRUN command has been executed and the emulator is started. System variable TST supplies 
the state of the trace module as described in a subsequent paragraph. 

The following is an example of a TRUN command used to start tracing when the emulator is 
connected: 


2. TRUN; 
? ERUN; 


Omit in stand-alone mode. 


5.11.6.1 System Variable TST. System variable TST is set to the current state of the trace module by 
the AM PL software. TST may not be assigned a value by the user, but may be displayed at any time. 
The display contains the status in the least significant three bits, as shown in table 5-4. The following is 
an example of a display statement to display TST: c " 


1 TST; 
>0001 


Display trace module status. Trace is 
running and neither event and delay nor 
trace operation has completed. 


5-52 


Digital Systems Division 


946244-9701 


Table 5-4. Trace Module Status 


Contents of Least 
Significant Digit 

Of System Variable TST Status 

0 Trace module is halted. Neither event and delay nor trace operation 
has completed. 

1 Trace module is running. Neither event and delay nor trace opera- 
tion has completed. 

2 Trace module is halted and trace operation has completed. Event 
and delay operation has not completed. 

3 Trace module is running and trace operation has completed. Event 
and delay operation has not completed. 

4 Trace module is halted and event and delay operation has com- 
pleted. Trace operation has not completed. 

5 Trace module is running and event and delay operation has com- 
pleted. Trace operation has not completed. 

6 Trace module is halted, event and delay operation has completed, 
and trace operation has completed. 

7 Trace module is running, event and delay operation has completed, 
and trace operation has completed. 


System variable TST may also be used with a mask value to test for a specific status condition as in the 
following example: 

? I F|6TST|6AND|62(6THEN|zi ' TRACE COMPLETED' Display the message if bit 14 of system 

variable TST is true. 

A mask value of 1 tests the status bit that is true when the trace module is running. A mask value of 2 
tests the status bit that is true when a trace operation has completed. A mask value of 4 tests the status 
bit that is true when an event and delay completion has occurred. 

5.11.7 STOP TRACE COMMAND. The Stop Trace command (THLT) stops the trace module, and 
returns the status in system variable TST. The syntax for the THLT command is as follows: 

7THLT ; 
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When the trace module has been started and has not been stopped by the internal circuitry or by the 
emulator, the TH LT command stops the trace module. The command displays the trace module status 
(system variable TST). Since the status is read after the trace module is halted, only the even numbers 
in table 5-4 apply. The following is an example of the THLT command: 

? THLT; Stop the trace module. Status indicates 

>0002 that the trace is stopped, the trace 

operation ^ as completed and the event 
and delay operation has not completed. 

5.11.8 READ LOW-ORDER TRACE MODULE MEMORY COMMAND. The Read Low-Order 
Trace Module Memory command (TTB) is a system function that reads the 16 low-order bits of the 
specified stored value. The syntax for the command is as follows: 

?TTB(<index>) 

The index operand may be any valid expression. When the value of the expression is a valid index to 
the trace memory, the command displays the value stored in the low-order 16 bits of the location 
corresponding to the index value. Two system variables contain the limits of valid index values. System 
variable TTBN contains the index value corresponding to the most recently stored value. System 
variable TTBO contains the index value corresponding to the oldest value stored. 

When the trace module is running, it stores a value in trace memory when the qualifiers have the 
specified values and a clock occurs. The trace module may be stopped internally when a specified 
number of values have been stored or when a specified number of events and a specified delay have 
occurred. In these cases, or when the operation is stopped by the emulator or by command before the 
event and delay have occurred or the trace operation has completed, the most recently stored value 
correspond to an index of zero. When the event and delay operation has completed before the trace 
module halts, the index value of zero corresponds to the value stored by the specified event, and values 
stored during the delay period (and during the time required by the emulator to complete execution of 
the current instruction) are accessed by positive index values. Values stored prior to the value 
corresponding to index 0 are accessed by negative index values. Figure 5-2 shows an example of trace 
memory contents, assuming that the fourth value traced was the specified event, and that a delay of two 
was specified. The example also assumes that the completion signal stopped the trace; no additional 
delay occurred. The index of -3 corresponds to the first value traced and negative values denote 
successive values traced. The event value corresponds to index value 0. The values corresponding to 
indexes 1 and 2 were stored at delay counts. 

In the trace module, the delay count and a further delay while the currently executing instruction 
completes, can cause additional values to be stored. When the total delay causes 256 or more additional 
values to be stored, the value associated with the specified event is overlayed by another value. The 
index value is also misleading. This problem can be avoided by limiting the magnitude of the value 
placed in the delay register by a TEVT command, and entering TBRK and EBRK commands that 
cause the trace module to stop. 

When the trace module is connected in the emulator control and data mode, the 16 bits read by the TTB 
command are either memory data or memory addresses, as selected by a TTRC command prior to the 
operation. In the other two connection modes, the bits are signals to which the probe leads 
corresponding to the 16 low-order bits (D4 through D19) are connected. 
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Figure 5-2. Trace Memory Contents After Trace 


When the target system uses a TMS 9980 microprocessor, each memory access transfers a single byte. 
Trace memory stores 16 data bits and four qualifier bits, when the trace module is connected in the 
emulator control and data mode. Figure 5-3 shows the contents of trace memory when data is traced 
and qualifier Q0 is masked off (not specified in the TTRC command). The first memory access after 
tarting the emulator is one in which QO is true. Subsequent memory accesses show Q0 alternately false 
and true. At each memory access during which QO is true, the most significant byte is the addressed 
byte and the least significant byte contains random data. At each memory access during which QO is 
false the least significant byte is the addressed byte, and the most significant byte is unaltered. The 
contents of trace memory when the trace is specified in this manner show the way in which the 8-bit 
accesses are combined in a 16-bit word, and also show that tracing with qualifier QO false selects only 
alternate memory accesses during which the word on the data bus coincides with the word as stored in 
target system memory. 

Alternatively, a TTB command and its operand may be used as a variable in an AM PL statement. The 
stored value corresponding to the value of the operand becomes the value of the command when used 
as a variable. 


The following are examples of TTB commands: 

? TTB (0) 

>78E2 


? TTB (25) 
>FFFF 


? NUADD = TTB(0) + 10 


Display the low order 16 bits of the value 
stored as the specified event. 

Display the low order 16 bits of the value 
stored at the 25th delay count following 
the specified event. 

Assign a value to user symbol NUADD. 
The value is the sum of the value in the low 
order 16 bits of the value stored as the 
event plus 10. 
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INDEX QO Q1 Q2 Q3 BITS 4 - ! 1 BITS 12-19 


1 

X 

X 

X 

BYTE 0 

xxxxxxxx 

0 

X 

X 

X 

BYTE 0 

BYTE 1 

1 

X 

X 

X 

BYTE 2 

XXXXXXXX 

0 

X 

X 

X 

BYTE 2 

BYTE 3 


note: 


BITS REPRESENTED BY X ARE BITS THAT MAY HAVE EITHER 
VALUE BYTES 0 THROUGH 3 ARE FOUR CONSECUTIVE BYTES 
OF TARGET MEMORY, WITH BYTE 0 CORRESPONDING TO ANY 
EVEN (WORD) ADDRESS. 


(A)1 37458 


Figure 5-3. Trace of Data Stored in Trace Module During Unqualified Trace of TMS 9980 

5.11.8.1 System Variable TTBO. System variable TTBO is set to the index value of the oldest value 
stored in memory by the trace module. TTBO may not be assigned a value by the user, but may be 
displayed when the trace module is not running. The value of TTBO is the smallest (most negative) 
value that may be used as an index in a TTB or TTBH command. When this value is greater than the 
value of system variable TTBN, no values have been stored and a TTB or TTBH command cannot be 
executed. The following is an example of a display statement to display TTBO: 

_? TTBO Display the most negative valid index to 

>FF80 trace memory. 

5.11.8.2 System Variable TTBN. System variable TTBN is set by AMPL software to the index value 
of the most recently stored value in trace memory. TTBN may not be assigned a value by the user, but 
may be displayed whenever the trace module is not running. The value of TTBN is the largest (most 
positive) value that may be used as an index in a TTB or TTBH command. When this value is less than 
the value of system variable TTBO, no values have been stored and a TTB or TTBH command cannot 
be executed. The following is an example of a display statement to display TTBN: 

? TTBN Display the most positive valid index to 

>005^ trace memory. 

5.11.9 READ HIGH-ORDER TRACE MODULE MEMORY COMMAND. The Read High-Order 
Trace Module Memory command (TTBH) is a system function that reads the four high-order bits of 
the specified stored value. The syntax for the command is as follows: 

? TTBH(<index>) 
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The index operand may be any valid expression. When the value of the expression is a valid index to 
the trace memory, the command displays the value of the four high-order bits in the location 
corresponding to the index value. The bits are displayed right-justified in a 16-bit word, zero-filled to 
the left. The limits of valid index values are the same as described for the TTB command. The four 
high-order bits accessed are stored by the trace module along with the 16 low-order bits accessed by a 
TTB command that specifies the same index. The description of index values in paragraph 5.11.8 
applies to the TTBH command also. 

An alternate form of the command displays a value of zero (false) or one (true), the result of comparing 
specified bits of the four high-order bits with specified values. The syntax for this form of the TTBH 
command is as follows: 



The index operand has the same form and limits as in the other form of the command. The second 
operand is a series of one to four keywords each preceded by a sign. The series denotes a value and a 
mask for comparison with the four high-order bits. When a keyword is preceded by a plus sign the 
value of the corresponding bit is one. When a keyword is preceded by a minus sign, the value for the 
corresponding bit is zero. The sign may be omitted preceding the first keyword; the plus sign applies. 
When a keyword is omitted, the bit is masked off, and is not used in the comparison. When the 
specified bits have the specified values, the command returns one. Otherwise, the command returns 
zero. The alternate keywords apply when the trace module is connected in the emulator control and 
data mode. 

Either form of the TTBH command may be used as a variable in an AMPL statement. 

The following are examples of TTBH commands: 

? TTBH (0) Display the high order four bits of the 

>000[) value stored as the specified event. 

? TTBH (0 Q0+Q1 -Q2 ) 'B1 Display the same value as the result of a 

<1 ~ ’ ’ comparison. 

? I FJ6TTBH ( 0 , EMU ) 0THEN TTB(0) Display the low order 16 bits of the value 

~ stored as the event when the event was also 

an emulator event (emulator control and 
data mode). 
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SECTION VI 

ERRORS AND RECOVERY 


6.1 INTRODUCTION 

Error messages are printed on the system console when errors are detected. This section lists the 
error messages and methods of recovery from errors. 

6.2 ERROR MESSAGE FORMATS 

AMPL software provides two categories of error messages. The warning messages are displayed 
when conditions which do not necessarily require termination of the command are detected. The 
error messages are displayed when error conditions are detected. The following is an example of 
a warning message: 


*** WARNING 204 0000 0001 

EMULATOR TRACING WITH TRACE/ 
CONTROL MEMORY SELECTED 


The number 204 is the message number. The leftmost hexadecimal number is the contents of 
workspace register zero, and the second hexadecimal number is the contents of workspace register 
one. The error message on the next line identifies the warning as the result of an emulator trace 
operation while the trace operation while the trace memory is available to the target system. 


The contents of workspace registers zero and one are printed with all messages; in the case of 
the example message, only the most significant byte oi workspace register zero is relevant. For 
an emulator DSR error, the DSR error code is in that byte, and it identifies the error as a device 
error; the emulator is unable to perform the operation required to read the target system 
registers (WP, PC, and ST). The user must refer to the operating system manual for explanations 
of DSR error codes other than the three listed in the message. 

The following is an example of an error message: 

*** ERROR 5 >9CC6 >2704 

I/O ERROR; UNABLE TO OPEN FILE 

The number 5 is the message number; the leftmost hexadecimal number is the contents of 
workspace register zero, and the second hexadecimal number is the contents of workspace 
register one. The error message identifies the error as an I/O error that occurs because the file 
cannot be opened. The only relevant information is the most significant byte of workspace 
register one, which contains the I/O error code (DSR error code) as listed in the operating 
system manual. The code in the example, 27 16 , indicates that the file name is undefined. 

Some types qf errors display a symbol also, as follows: 

*** ERROR 103 TSTP =>AAA6 >0009 

SPECIFIED SYMBOL HAS NOT BEEN DEFINED 
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The number 103 is the message number, which is followed by the characters of a symbol, an 
equal sign, the contents of workspace register zero, and the contents of workspace register one. 
The error message on the next line identifies the error. The contents of the workspace registers 
are not relevant in this case. 

Only eight error messages are memory resident; these are error messages for errors that occur more 
frequently. The messages for errors 1, 5, 6, 7, 103, 113, 1 17, and 224 are memory resident and are 
printed whenever these errors occur. Messages for the remainder of the errors are on an error message 
file; when this file is available messages are printed for all errors. When this file is not available only the 
first line (containing the error number, optionally a symbol, and the contents of workspace registers 
zero and one) is printed when errors other than those for which the messages are resident occur. The 
circumstances under which the error message file is available differ for different operating systems. 

Under TX990 the error message file is on the system diskette. When the system diskette is on floppy 
disk unit 1 (lefthand unit) the error message file is available. If the system diskette is on another floppy 
disk unit, or if the error file has been deleted to provide more space on the system diskette for other 
files, the error message file is not available. 

Under DX10, the error message file is installed under the pathname ,S$SYSLIB.AMPL$ET1. When 
this is done, error messages are available unless the error message file has been deleted or its pathname 
changed, or the disk volume has been unloaded. 

During initialization of AM PL software, immediately after loading the software, the error message file 
is opened. If the file is not available, message number 5, UNABLE TO OPEN FILE, is displayed. 
When errors for which error messages are not memory-resident occur, the user will have to look up the 
error message from table 6-1. 

If the user should remove the system diskette or unload the disk volume that contains the error message 
file, and an error occurs (other than those for which the messages are memory-resident), the software 
prints message 7, I/O ERROR; READ ERROR. Any further errors are identified as if the error file 
had not been opened. 

Table 6-1 lists the message numbers and their significance, and the possible ways of recovering 
from the error. It also indicates which messages display a symbol, and which register contains 
relevant information. Some message numbers may appear in either a warning message or an error 
message, depending on the severity of the condition in the context within which it is detected. 
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INTERNAL ERROR; UNDEFINED No Not relevant Not relevant Check that operators are 
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dimensions is greater than 
32767, correct the dimension 
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SECTION VII 
EXAMPLES 


7.1 INTRODUCTION j t , , 

This section contains examples of the use of AMPL statements and commands to debug a 
program The examples all relate to an example program, showing how commands may be used 
to load the program, to determine that the instructions in the program are executed in the 
proper sequence, and that the results are correct. The examples and applications of an AMPL 
system to the debugging of a program are not intended to be exhaustive, but to be typical ot 

what the user can do. 

7.2 EXAMPLE PROGRAM 

The example program consists of a driver and a sine-cosine subroutine. The driver includes a set 
of values of angles, buffers for results, and a loop of instructions to call the subroutine to 
compute the sine and cosine for each angle, and store the results. The subroutine consists ot a 
set of instructions to initialize the registers for the computation, and a loop of instructions to 
perform the computation. After executing the loop 12 times, the subroutine returns control to 
the driver program. The subroutine uses a table of 12 arctangents in the computations. 

Assemble the source code either with TXMIRA under TXDS or with SDSMAC under DX10, 
following the operating instructions in the appropriate system documentation. Figure 7-1 shows the 
source listing printed when the program was assembled by TXMIRA. 

1. Perform steps 1 through 5 of the procedure in paragraph 5.2.2 to load TXDS and to 
start execution of the operating system. 

2. Enter an exclamation point (!). TXDS should request a program name. Request 
TXMIRA as follows: 

PROGRAM: :TXMIRA/SYS 

3. Define the input (source file) as follows, using the file name assigned when the file was 
written: 

INPUT: :SINTST/TEM 

4. Enter the device name of the device on which the listing is to be printed, as follows: 

OUTPUT: ,L0G 

5. Enter the desired assembler options, as follows: 

OPTIONS: LS 

6. TXDS prints the following messages as it loads and executes TXMIRA: 

TXMIRA 936227 ** 

When TXMIRA completes the assembly, control returns to TXDS, which requests another 
program . 
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I NT ST 


TXMIRft y36 

££7 ♦♦ 

PftGE 0001 

0 0 0 1 



♦ 




0 0 03 



♦ DRIVER FOR SINE - COSINE S 

UBROUTINE 

0 0 03 



♦ 




0004 




IDT 

SI NT ST' 


0005 


0 0 0 0 

RO 

EQU 

0 


0006 


0 0 0 1 

R1 

EQU 

1 


0007 


0 0 0£ 

R£ 

EQU 

lL 


0008 


0 0 03 

R3 

EQIJ 

■Z> 


0009 


0 0 04 

R4 

EQIJ 

4 


0 0 1 0 


0 0 05 

R5 

EQIJ 

5 


001 1 


0 0 06 

R6 

EQU 

6 


001 £ 


0 0 09 

R9 

EQU 

Q 


0 0 1 3 


00 OR 

RIO 

EQU 

10 


0014 


0 0 OB 

R 1 1 

EQU 

l i 


0015 

0 0 0 0 


WSP 1 

BSS 

18 

REGISTERS 0 - 8 

0 0 1 6 

0 0 1 £ 

0 0 0E 


DftTft 

14 

REGISTER 9 - LOOP COUNT 

0 0 1 7 

0 0 1 4 

0 0 0 0 


DftTft 

0 

REGISTER 10 - LOOP COUNTER 

001 S 

0 0 1 6 



BSS 

10 

REGISTERS 11-15 

0 0 1 9 

0 0£ 0 

0 1 0 0 

ftNGLE 

DftTft 

> 1 0 0 

1 DEGREE 

0 08 0 

0 0££ 

08 0 0 


DftTft 

> 8 0 0 

£ DEGREES 

0 0£ 1 

0 0£4 

04 0 0 


DftTft 

> 4 0 0 

4 DEGREES 

0 02£ 

0 086 

08 0 0 


DftTft 

> 8 0 0 

8 DEGREES 

0083 

00£8 

1 0 0 0 


DftTft 

> 1 0 0 0 

16 DEGREES 

00£4 

0 OE'ft 

IE 00 


DftTft 

> 1 E 0 0 

30 DEGREES 

m;i£5 

0 08 C 

3C 0 0 


DftTft 

> 3C 0 0 

60 DEGREES 

I'l Me* 6 

0 0£E 


S I NE 

ESS 

14 

SINE BUFFER 

0087 

fi 03C 


COS 

BSS 

14 

COSINE &JFFP£R 

0088 

0 0 4 ft 

0£E0 

BEGIN 

LWPI 

WSP1 

LORD WORK.SPftCE POINTER 


0 04C 

0 0 o o 





0 089 

0 04E 

04CFI 


CLR 

R 1 0 

FESE T i COUNTER 

0 03 0 

0 050 

C8£ft 

COMP 

MOV 

•JftNGLE <R 1 0.j > i > I NP 

MD’VE ftNGLE TO CftLLING SEQUENCE 


0 058 

0 0£ 0 






0 054 

005ft ■ 





0 031 

0056 

06 ft 0 


BL 

S'SINCOS 

BRftNCH TO SUBROUTINE 


0 058 

0074 





0 038 

005ft 

0 0 0 0 

INF' 

DftTft 

o 

ftNGLE 

0 033 

0 05 C 

0 0 0 0 

SIN 

DftTft 

0 

SINE 

0 034 

0 05E 

0 0 0 0 

COSN 

DftTft 

0 

COSINE 

0035 

0 06 0 

CftftO 


MOV 

QSINj SSINE <R 1 0 :• 

MOVE SINE TO BUFFER 


0 068 

005C ■’ 






0 064 

00£E ' 





0 036 

0 066 

CftftO 


MOV 

5'COSNj SC OS <R1 0> 

MOVE COSINE TD BUFFER 


0068 

0 05E- 






0 06ft 

UU3U ■' 





0 037 

n 06C 

05Cft 


INCT 

R 1 0 

INCREMENT INDEX 

n n 38 

0 06E 

8£4ft 


c 

R 1 0 * R 9 

FINISHED? 

0039 

0 070 

11EF 


JLT 

COMP 

CONTINUE 

0 04 0 

0078 

0340 


IDLE 


THftT-S ftLL ! 


(A) 1 36544 (t/2) 


Figure 7-1. Example Program Listing (Sheet 1 of 3) 
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SINTST 


TXMIRA 93622? ♦♦ 


PAGE 00 02- 


0 042 



♦ 


0 043 



♦ SI NCOS Si 

UBROUT I NE 

0044 



♦ 


0 045 



♦ SI NCOS C! 

OMPUTES THE S II 

0 046 



♦ 


0 04? 



♦ CALL I NG 

SEQUENCE: 

0043 



♦ EL 

SS I NCOS 

0049 



♦ DATA 

ANGLE 

0 05 0 



♦ DATA 

0 

0 05 1 



♦ DATA 

0 

0052 



♦ 


0 05 3 



♦ THE SUBROUTINE ALTERS 

0 054 



♦ 


0055 



♦ THE OUTPUTS ARE SIGNED 

0056 



♦ 


0 05? 

0 0?4 

04C0 

SI NCOS CLR 

RO 

0053 

0 0?6 

C0?B 

MOV 

♦R 1 1 + > R 1 

0 059 

0 0?8 

05 0 1 

NEG 

R1 

0 06 0 

00? A 

04 C 2 

CLR 

R2 

0 06 1 

oo?c 

0203 

LI 

R3 - > 4DBA 


OOZE 

4DBA 



0062 

0 03 0 

04 C 4 

CLR 

R4 

0063 

0032 

Cl 43 

MOV 

R3-R5 

0064 

0 034 

04 C 6 

CLR 

R6 

0 065 

0 086 

C041 

SEP MOV 

Rl-Rl 

0 066 

0083 

1 1 05 

JLT 

NEG 

0 06? 

0 08 A 

6085 

S 

R5-R2 

0063 

0 osc 

A0C4 

A 

R4-P3 

0069 

0 08E 

6 066 

S 

SATAN < R6> » R1 


0 090 

00B4" 



oo?o 

0 092 

1 0 04 

JMP 

COM 

0 0?1 

0 094 

A 085 

NEG A 

R5-R2 

0 0?2 

0096 

60C4 

S 

R4 - R3 

00?3 

0 093 

A 066 

A 

SATAN <R6> - R 1 


0 09A 

00B4 ' 



00?4 

009C 

0580 

COM I NC 

RO 

00?5 

0 09E 

05C6 

INCT 

R6 

00?6 

00A0 

Cl 02 

MOV 

R2-R4 

00?? 

0 0A2 

08 04 

SR A 

R4-R0 

0 0?3 

0 0A4 

Cl 43 

MOV 

R3-R5 

00?9 

0 0A6 

08 05 

SRA 

R5-R0 

0 03 0 

0 0A8 

0280 

Cl 

R 0 - 1 2 


0 OAA 

0 0 OC 



0 03 1 

0 OAC 

1 1 EC 

JLT 

SER 

0082 

0 OAE 

CEC2 

MOV 

R2 - ♦R 1 1 + 

0 033 

00B0 

CEC3 

MOV 

R3- »R1 1+ 

0034 

0 0B2 

04 5 B 

RT 

RETURN 


IN DEGREES ♦ 256 
SI HE RETURNED HERE 
CDS I HE RETURNED HERE 


R6 HND R 1 1 


INITIALIZE SHIFT COUNT 
GET ANGLE 
NEGATE ANGLE 
INITIALIZE SINE 
INITIALIZE CDS I HE 

INITIALIZE SINE ONE 
INITIALIZE COSINE ONE 
INITIALIZE INDEX REGISTER 
START SERIES- TEST SIGN 
JUMP IF NEGATIVE 
SUBTRACT COSINE ONE FROM SINE 
ADD SINE ONE TO COSINE 
SUBTRACT ARCTANGENT FROM ANGLS 

BRANCH TO COMMON CODE 
ADD COSINE ONE TO SINE 
SUBTRACT SINE ONE FROM COSINE 
ADD ARCTANGENT TO ANGLE 

INCREMENT SHIFT COUNT 
INCREMENT INDEX REGISTER 
MOVE SINE TO SINE ONE 
DIVIDE SINE ONE BY 2*>R0 


MOVE COS 
DIVIDE C 


INE TO COSINE ONE 
OSINE ONE BY 2*»R0 


SHIFT COUNT LESS THAN 12? 

YES - CONTINUE 

MOVE SINE TO CALL SEQUENCE 

MOVE COSINE TO CALL SEQUENCE 


Figure 7-1. Example Program Listing (Sheet 2 of 3) 
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INTST 



TXMIPft 936887 ♦♦ 


0084- 




♦ ARCTANGENTS 

0u 8 "5 

0 0£ 4 

SB 00 

ATAN DATA 

2D 00 

0 036 

00B6 

1ft 90 

DATA 

> 1A90 

0 037 

00B8 

OE 09 

DATA 

> E 09 

0 033 

00 BA 

0720 

DATA 

> 72 0 

0088 

0 0BC 

0394 

DATA 

> 394 

0 09 0 

0 0BE 

OlCft 

DATA 

MCA 

0091 

0 oc 

0 

00E5 

DATA 

:• E5 

0098 

0 oc 

d 

0073 

DATA 

f • 

0 093 

0 oc 

4 

0039 

DATA 

■> 3 9 

0094 

0 oc 

6 

oo in 

DATA 

> 1 D 

0095 

0 oc 

8 

000E 

DATA 

>E 

0096 

0 oc 

ft 

0007 

DATA 

> 7 

0097 




END 

BEGIN 


R ANGLE 

0080 

R ATAN 

0 0B4 

R CD MR 

0050 

R CDS 

0 03C 

R NEG 

0094 

R0 

0 0 0 0 

R 1 1 

00 0B 

R2 

0 0 08 

R5 

00 05 

R6 

0 0 06 

R SIN 

005C 

R 3 I NCOS 

0074 

j ij u ij ERE DR 

3 




(A) t 36544 (3/3) 


PAGE 0003 


BEGIN 

0 04 ft 

R COM 

0 09C 

(DSN 

0Q5E 

R INF 

0 05ft 

R 1 

0 0 0 1 

R 1 0 

0 0 Oh 

R3 

0003 

R4 

0 0 04 

R9 

0 009 

R SEE' 

0 086 

SINE 

008’E 

R WSF'l 

0 0 0 0 


Figure 7-1. Example Program Listing (Sheet 3 of 3) 


7.3 LOADING THE EXAMPLE PROGRAM 

Prior to loading the example program, the AM PL program must be loaded and started. Perform the 
steps in the appropriate paragraph of Section V (depending on the operating system). 

Before loading the program, accessing system variables ETM or EUM, or accessing target memory, 
the emulator must be initialized. The first command to be entered is an EINT command, as in the 
following example: 

? EINT (‘EMU’) Initialize Emulator EMU. 

The example uses the device name EMU which applies to a TX990 system supplied by Texas 
Instruments. Substitute the correct device name for other operating systems; e.g., EM01 for DX10. 

The AMPL program loads programs into target system memory by executing a LOAD command. 
Target system memory addresses 0 through 1 FFF| 6 may be mapped either into emulator memory or 
target system memory. Prior to entering a TOAD command the user should display the system 
variables that control mapping, as follows: 

?_EUM: B1 

<1 
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The display of system variable EUM shows that it has been set to one, mapping address 0 through 
1 FFFis into the user memory of the emulator. It is assumed that the example program will be stored in 
PROM, and should be tested in emulator memory. The value of one, then, is the desired value. Display 
the other variable as follows: 

?ETM:B1 

<1 

The display of system variable ETM shows that it has been set to one, mapping addresses FEOOu 
through FFFF 16 (3E00i 6 through 3FFF , 6 in a target system using the TMS 9980) into the trace 
memory of the emulator. Since the example program does not occupy this area of memory, either value 
of ETM would be satisfactory. If it were necessary to map memory differently, the system variables 
EUM and ETM would be assigned the correct values by entering assign statements. The user should 
verify the mapping of memory before beginning the debug session. 

Next, enter the LOAD command to load the example program, as follows: 

?L0AD( 1 DSC:SINTST/OBJ 1 ,>100) 

The first operand consists of the device name of the device on which the object file resides, and the file 
name The example shown applies to TX990; a DX 10 pathname would be used in a DX10 system The 
second operand causes the AMPL program to load the example program at address 100, «. If the 
operand is omitted, the program is loaded at address A0i6- The value of 100i6 is chosen to simplify the 
computation of target memory addresses from the relative addresses shown in the assembly listing. In 
many cases the load address may not be chosen arbitrarily, but is determined when available memory is 
allocated for target system requirements. 


7.4 INITIAL DEBUGGING 

To check that the program is loaded as intended, and to verify a constant in the subroutine 
enter the following command: 

l @(>7E+>100) :H 
>4 DBA 


Referring to the assembly listing on sheet 2 of figure 7-1, notice that the fifth instruction in 
subroutine SINCOS is an LI instruction that places an initial value in workspace register 3. The 
preceding command displays the constant (at location 7E 16 relative to the first location ot the 
program) as a hexadecimal value. The result is the correct value, verifying both the loading 
of the program and the constant on which the computations depend. 
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The subroutine also uses a table of arctangent values in the computation. The following example 
uses a command statement to verify these values: 

2 BEGIN 

22 AT AN = >B4+>100; 

1? CNT = 0; 

1? WHILE|6CNTjt5LT|!S240DO 
BEGIN 

@(ATAN + CNT) tHXXXXX; 

@(ATAN + CNT + 2) tHXXXXX; 

@ ( AT AN + CNT + 4) :HN : 

CNT = CNT + 6 
END 


>1A90 >0E09 
>0394 >01CA 
>0073 >0039 

> 000 e mw 


The example uses an assign statement to assign the user symbol ATAN to the address of the 
table, and another assign statement to clear the user variable CNT. Then, using a WHILE 
statement that contains a compound statement, the examples prints the 12 constants as decimal 
values, three on a line. The values are correct, and verify that the data to be used in the 
computations is correct. 

7.5 USING THE EMULATOR 

In order to execute the program, an ERUN command must be entered. However, the user should 
set up a condition or conditions for stopping the emulation before executing the ERUN 
command. The EBRK command defines a breakpoint and specifies whether the breakpoint 
occurs when an event occurs, when a trace operation completes, or at either an event or a 
completion of a trace operation. The EEVT command defines an event as either the result ot a 
comparison defined by an ECMP command, or an external event. The ETRC command defines a 
trace operation. These commands can be used in various combinations to stop emulation at a 
point that allows the user to verify whether the portion of the program being tested has 
executed properly. 


1 ? 

2 ? 

2 ? 

22 
2 2 
22 

J2 END 

>2D00 
>0720 
>00 E 5 
>00 ID 


Referring to sheet 3 of figure 7-1, the END directive of the source program defines BEGIN as the 
entry point. The LOAD command should have placed the address corresponding to label BEGIN 
in the target system program counter. If the user sets up a trace ot five instructions and a 
program count comparison of 14 Ei 6 , the emulator should execute two instructions. However, 
should the program contain an error that causes a transfer ot control that prevents the execution 
of the specified instruction, the trace operation would stop emulation after execution ot five 
instructions (TMS 9900), and examination of trace memory contents would show which instructions 
had been executed. The following example shows the necessary commands: 


2ETM = 0 
?EEVT ( INT ) 


Target memory addresses should not be 
mapped into trace memory while tracing 
is being done. 

Event is internal. 


2ECMP(IAQ,>14E) 


Compare program counter to I4 Ei<,. 
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?ETRC(IAQ,5,INT) 

?ERUN; 


Trace five program counter values 
(TMS 9900). 

Start emulation. 


In a TMS 9980 system, the same commands could be used, but if the comparison did not occur before 
the trace completion signal stopped the emulator, six addresses would have been stored. These 
addresses would be the addreses of the bytes that contain three instructions. To trace five instructions 
as in the example, the ETRC command for a TMS 9980 system would be: 

?ETRC(IAQ,10,INT) 

The emulator should begin emulation at the address in the target system program counter and 
halt emulation and request an entry by printing a question mark. The user enters a command to 
determine where emulation was halted, as in the following example: 


? DR; 


R0 = >0000 R8 = >0000 PC = >0150 / >C82A MOV @>0120(R10) ,@>JZfl5A 

R1 = >0'M0 R9 = >000 E WP = >0100 

R2 = >0000 RI0 = >0000 ST = >2200 

R3 = >J3d0d Rll = >0000 * 

R4 = >0000 R12 = >Wffi 

R5 = >0000 R13 = >0000 

R6 = >0000 R14 = >0000 

R7 = >0000 R15 = 


The contents of PC is 150 16 , indicating that the emulator was halted by the breakpoint at 
14E 16 , and that the program has executed correctly to this point. The contents of WP ( 1 00 1 6 ) 
show that the LWPI instruction executed correctly, and the contents of R10 show that the CLR 
instruction executed. Contents of other registers and workspace registers may differ from those 
shown in the example. 

7.6 TRACING WITH THE EMULATOR 

The user could set up another breakpoint comparison, or another trace, at this point. However, 
the user could also execute another ERUN command, using the same breakpoint comparison 
already set up, and the same trace parameters. The comparison should not occur again, because 
control should not return to this point in the program unless it is restarted. Tracing five 
instructions should cause the emulation to halt following the third instruction of subroutine 
SINCOS. The user enters an ERUN command, as follows: 


?_ERUN ; 

The command starts emulation, which halts either as a result of the specified comparison or after 
tracing five instruction addresses. The user displays the PC to determine which breakpoint was 
effective, as follows: 

?PC 

PC = >017A 
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This value in the PC indicates that the emulator was halted when five instructions had been 
traced. The user may enter the following to determine which instructions were traced: 


_? N = ETBO 

l WHILEt6N0LE0ETBN0DO0BEGIN 
1? ETB(N) :HN 

1_? N = N + 1 

1?_ END 

>0150 

>0156 

>FT74 

WL76 

WL78_ 


Set N to index of oldest value traced. 
Perform compound statement until N is 
equal to index of newest value traced. 
The compound statement displays the 
indexed value and increments the index. 


The results of the preceding example are the addresses of the five instructions emulated 
following entry of the ERUN command. 


In a TMS 9980 system, using the proper ETRC command, ten addresses would be stored as follows: 

>0150 

>0151 

>0156 

>0157 

>0174 

>0175 

>0176 

>0177 

>0178 

>0179 


The correct instructions were emulated. The user could display register contents to verify the accuracy 
of the computation, as follows: 

l R0 

R0 = >0000 
l R1 

R1 = >FF00 

The zero in R0 verifies operation of the CLR instruction at location 0174 16 . The result in R1 
verifies that the MOV instruction at location 150 16 , the MOV instruction at location 176 lf) , and 
the NEG instruction at location 1 78 16 operated correctly. 

7.7 MONITORING PROGRAM EXECUTION 

The user may then enter a series of commands to emulate the loop of instructions in the 
S1NCOS subroutine and display register contents showing the results. The commands repeat the 
operation for each iteration of the instructions, allowing the user to verify the steps of the 
computation. Tirst, the EBRK command should be entered as follows: 

]_ ERBK (EVT) Det "me breakpoint to occur on compare 

only. 
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Change the comparison by entering an ECMP command as follows: 

_? ECMP (IAQ,>1A8) Breakpoint at Cl instruction at end of 

loop. 

The breakpoint has been altered so that completion of the defined trace operation does not halt 
the emulator. Tracing may still be done, however, and tracing of addresses yields helpful 
information. Change the trace definition as follows: 

_? ETRC ( I AQ , 256 ) Change the trace count to 256. 


Enter a REPEAT statement to emulate the instructions repeatedly, as follows: 


? 

REPEAT0BEGIN 

Execute a compound statement repeat- 

it 

ERUN; 

edly until target system workspace regis- 

1? 

R0 

ter 0 contains 12. The compound state- 

1? 

R1 

ment starts emulation and displays target 

1? 

R2 

system workspace contents when a 

1? 

R3:HN 

breakpoint stops emulation. 

1? 

R4 


1? 

R5 


1? 

R6:HN 


1? 

END0UNTIL0RO0EQ012 



The statement should produce 12 sets of contents of the seven registers used in the computation. 
The following shows the portion of the results displayed during the first iteration of the loop: 

R0 = >0001 R1 = >2 CM R2 = >4DBA R3 = >4DBA 

R4 = >26 DP R5 = >26DD R6 = >0002 

7.8 DISPLAYING TRACED ADDRESSES 

Before analyzing the data in the registers, the user may wish to display the traced addresses. If the target 
system has correctly executed the program in a TMS 9900 system, the trace should consist of 14 
addresses stored during the last iteration, following execution of the ERUN command. If the program 
has not been correct, there could be as many as 256 addresses stored. These would be the addresses 
of the last 256 instructions emulated. The following is an example of commands to display trace 


memory contents: 




IN = ETBO 

Set user variable N to 

the index 

of the 


oldest value traced. 



? REPEAT0BEGIN 

Display stored values 

until the 

index 

1? ETB(N) :HN; 
1? N = N + 1 

equals zero. 



1? END UNTIL N GE 0 
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>01 AC 
>0186 
^188 
>018A 
>018C 
>018E 
Wi92 
>019C 
>019E 
>MA0 
3^TA2 
WiM 
>01A6 
>01 A8 


In a TMS 9980 system, the trace consists of 28 addresses if the target system has correctly executed the 
program; there could otherwise be as many as 256 addresses stored. These addresses would be the 
addresses of both bytes of the last 128 instructions emulated. The stored addresses for a correctly 
executing system are: 


>01 AC 
>0 1 A L) 
>0186 
>0187 
>0188 
>0189 
>01 8 A 
>01 8B 
>01 8C 
>01 8D 
>018E 
>01 8F 
>0192 
>0193 
>01 9C 
>019D 
>019E 
>01 9F 
>01 A0 
>01 A 1 
>01 A2 
>01 A3 
>01 A4 
>01 A5 
>01 A6 
>01 A7 
>01 A8 
>01 A9 
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The display of addresses in the preceding example shows that the loop ot instructions was 
executed in the proper order. The user may analyze the workspace register contents previously 
displayed and determine that the computation is correct. The first instruction to be executed 
when an ERUN command is entered is a JLT instruction. The user may display the status 
register contents as follows: 

? ST 

ST = >3200 

Status register bits 2, 3, and 6 are set to one, indicating that the Equal, Carry, and XOP bits 

have been set. Bits 0 and 1 equal to zero and bit 2 equal to one indicate that the result of the 

comparison in the last instruction emulated is correct, and the MOV instruction at address 

1AE 16 should be executed following the JLT instruction when an ERUN command is entered. 

7.9 CHECKING PROGRAM RESULTS 

The next breakpoint should allow the user to verify proper exit from the subroutine and storing 
of the sine and cosine values computed. The user may enter another ECMP command and an 
ERUN command as follows: 

? ECMP ( - DB IN , >13C) Compare the addresses of write opera- 

tions to 13C X 6 . 

? ERUN; Resume emulation. 

The breakpoint should occur following execution of the MOV instruction at location 166 16 . 
When the AMPL program requests another command, the user may verify the point at which 
emulation halted by displaying the PC, as follows: 


_? PC 

PC = >016C 

The PC contents indicate that the instructions were executed in the proper sequence. If the 
emulation had halted at some other point, the traced addresses could be examined to determine 
what happened. 

At this point the sine and cosine of 1° should have been stored in locations SINE and COS ot 
the driver program. The values are signed binary fractions, and are not directly convertible to 
decimal fraction values in trigonometric tables. The values may be displayed as decimal integers, 
as follows: 


l @>12E: DN 
570 

l_ @>13C:DN 
32761 


Display contents of address 12E J6 
(SINE) in decimal format. 

Display contents of address 13C 16 
(COS) in decimal format. 
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Divide these values by 32.768 to obtain decimal fraction equivalents. The computations of 
subroutine SINCOS for a single value are valid. The user may set the breakpoint to another 
value, emulate the subroutine for each angular value, and display the answers, as follows: 


2.ECMP (ADDR,>172) Set breakpoint to compare memory 

addresses to 172j 6 . 

?_ERUN i Start emulator. 

IRC Verify breakpoint. 

PC = >0174 


? P ROC0SCDUMP (0,l)fcSBEGIN 
11 'ANGLE SINE COSINE'; 

11 NL; 

11 LOC01 = 0; 

H WHILEftfLOCtf 10LE012$DO 
1? BEGIN 


2? 


@(>120 

+ L0CJ6 1 ) / 2 56 : 1 

2? 


@(>12E 

+ LOC01) : DXXX 

2? 


@(>13C 

+ L0C|z51 ) :DN ; 

2? 


LOC01 = 

= LOC01 + 2 

2? 


END 


1? 

END 



1SCDUMP; 



ANGLE 

SINE 

COSINE 


1 

570 

32761 


2 

1144 

32747 


4 

2294 

32689 


8 

4450 

32448 


16 

MI 

31504 


3F 

16388 

28367 


60 

28376 

16388 


Define procedure to display results in 
tabular format. 


Execute procedure. 
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When the values in the SINE and COSINE columns are divided by 32,768, the results are the 
more familiar decimal fraction equivalents. The user may enter new values for angles and repeat 
the test, as follows: 


_?>120:H? 

:H 


Display and modify first angle. 

>0120 / 

>0 100 

=? = >2C00 


>0120 / 

>2C00 

= ? 

Display and modify second angle 

>0122 / 

>0200 

“ = >1600 

>0122 / 
>0124 / 

>1600 

>0400 

=? 

~ = >B00 

Display and modify third angle. 

>0124 / 

>0B00 

= ? 

Display and modify fourth angle. 

>0126 / 
>0126 / 

>0800 

>5900 

~=f = >5900 
= ? 

>0128 / 
>0128 / 
>012A / 
>012A / 
>012C / 

>1000 

>0F00 

>1E00 

>0700 

>3C00 

= 0F00 

= ? 

~^f = 0700 
=? 

= 0300 

Display and modify fifth angle. 
Display and modify sixth angle. 
Display and modify seventh angh 

>0 12 C / 

>0300 

= ? • 
• 3 


?PC =>14A 

?ERUN; 

7SCDUMP; 


Set PC to start of program. 
Emulate program with new data. 
Display results. 


At this point, the subroutine computations have been verified using 14 different angle values. 
The user may verify the subroutine more thoroughly by computing additional sines and cosines, 
or may accept the program as having been tested adequately. 

7.10 USING THE TRACE MODULE 

Had the sines and cosines not been correctly calculated, the user may want to execute 
subroutine SINCOS tracing all memory addresses and data. Analysis of traced addresses and the 
data in those addresses should identify the error in the calculations. Assuming that the trace 
module is connected in the emulator control and data mode, the following commands would 
trace the SINCOS subroutine: 

?TINT(‘TRA’) Initialize trace module (TX990; TR01 for 

DX 10). 

?TBRK(OFF,OFF) Turn off trace module breakpoint 

conditions and action. Trace module is to 
operate under emulator control. 

?TTRC(DATA+OFF,256.EXT.OFF) Trace 256 words of memory data. 

following the clock from the emulator, 
with the latch mode off. 

7TRUN: Trace module starts when ERUN 

command is executed. 

?EBRK.( EVT.SELF) Define breakpoint to stop the 

microprocessor when an event occurs. 
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TEEVT(INT) 

_?ECMP( IAQ,>1A8) 


2ETRC(ADDR,256,EXT) 


?PC = >14A 


Define an event as a signal from the internal 
comparison circuitry. 

Compare instruction addresses to 1A8 16 . A 
breakpoint occurs when the instruction that 
closes the loop in subroutine SINCOS is exe- 
cuted. 

Trace 256 addresses, clocked by the target 
system clock enabled by a signal from the 
trace module. 

Start execution at location BEGIN of driver 
routine. 


2ERUN; 


Start the microprocessor. 


The commands in the example trace all memory accesses in a TMS 9900 system, storing the memory 
address in the emulator trace memory, and the memory data in the trace module memory. The trace 
module memory contains signals 1AQ, DB1N, and EMU in the high-order bits. The addresses were 
stored in the emulator simultaneously with the storage of data in the trace module; however, the 
indexes are not necessarily equal. The address stored at the index in system variable ETBO 
corresponds to the data stored at the index in system variable TTBO, and both addresses and data are 
stored sequentially following these indexes. 

In a TMS 9980 system, the commands listed for the TMS 9900 system could be used, but would trace 
addresses and data that serve no purpose. By changing the TTRC command as follows, the trace of a 
TMS 9980 system is similar to that of a TMS 9900 system: 

2JTRC(DATA-QO,256,EXT.OFF) Trace 256 words of memory data, storing 

the contents of the data bus only when the 
complete memory word is on the bus. 

The ETRC command specifies EXT, which causes the emulator trace clock to be enabled by the trace 
module trace clock, synchronizing the trace in the emulator to that in the trace module. The addresses 
traced in the emulator are odd addresses, each of which is one greater than the address of the word 
stored in the trace module memory. 


To determine the cause of erroneous results the user is mainly concerned with memory write 
accesses. The data stored in the trace module memory is the data written, and represents the 
results of the computations. The following example shows commands to print the emulator trace 
index, the address, and the data for each write access stored in the trace memories: 


?N = ETBO 

Set variable N to oldest index for emulator 
trace memory. 

m = TTBO 

Set variable M to oldest index for trace 
module memory. 
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MULE N|*LE|*0|*D0tfBEGIN 
1? IF TTBH (M,-DBIN)0THEN0BEGIN 
2J_ N : DXX 

2]_ ETB(N) :HXX 

2? TTB (M) :HN 

2? END 

T? M = M+l 

1? N = N+l 

1?END 

Examining the results of executing these commands should identify the error in the calculations. 


The commands in the preceding example may be used in a TMS 9980 system, and will display the 
addresses of the least significant bytes of the words displayed. By changing the statement on the fourth 
line (the one that displays the address) the user may display the same information as on a TMS 9900 
system. The statement may be changed as follows: 

2? (ETB(N) - 1):HXX 
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APPENDIX A 

TX990 SYSTEM GENERATION 


Texas Instruments supplies three versions of the TX990 operating system with the AM PL system. One 
of these versions uses the 913 Video Display Terminal (VDT) as the system console, another uses the 
733 ASR Electronic Data Terminal as the system console, and the third uses the 9 1 1 VDT as the system 
console. The user may wish to generate a TX990 operating system to support the AMPL system for 
various reasons. Some reasons for generating a system are as follows: 

• To provide more working storage in memory by eliminating support of devices that are not 
required. 

• To include the Operator Command Package, which provides operator interface with 
TX990. 

• To include support of a device (or devices) not supported by a standard TX990 system. 
Generating a system requires the following: 

• The TX990 parts diskette (part number 937803-2601) 

• AMPL system diskette (part number 937745-0007) 

• One of the following TXDS system diskettes: 

— For 911 VDT System Console (part number 937803-2605) 

— For 913 VDT System Console (part number 937803-2602) 

— For 733 ASR System Console (part number 937803-2603) 

• A scratch diskette on which the newly generated system is stored. 

In the following system generation procedures, the characters output by the system are underlined 
when both output and user input are shown. Commands are preceded by asterisks (*). 

The procedures include those for executing the following utility programs: 

• SYSUTL — Initialize time and date. 

• TXCCAT — Copy object code of TXDS control program to the TX990 parts diskette. 

• INITDSC — Initialize new system diskette. 

• GENTX — To generate source code for TASKDF and TXDATA modules of system. 
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• OBJMGR - To select and copy modules required for new system to file TXPART/OBJ 
for input to TXLINK. 


• TXMIRA — To assemble modules TASKDF and TXDATA. 

• TXLINK - To link modules TASKDF, TXDATA, and those copied to TXPART/OBJ 
to form new system on file NEWSYS/SYS. 

• SYSUTL - To copy system loader to the new system diskette, and to designate the 
newly linked system as the current system. 

GENTX is an interactive program that accepts system parameters and device designations and 
generates source code for the system data modules TASKDF and TXDATA. In the portion of 
the procedure that applies to GENTX, default values apply when no value (carriage return only) 
is entered. Refer to the Model 990 Computer TX990 Operating System Programmer’s Guide for 
the default values and for complete system generation information. In the portion of the 
procedure that applies to defining devices, omit the definition of any devices that are not to be 
supported by the new system. All device names are completely arbitrary and may be changed as 
desired. 

To generate a new TX990 system, perform the following steps: 

1. Place the TX990 parts diskette in the right hand floppy disc unit, and the TXDS 
system diskette in the left hand unit. Place both units in ready. 

2. Press the HALT/SIE switch on the programmer panel of the computer. 

3. Press the RESET switch on the same panel. 

4. Press the LOAD switch on the same panel. 

5. The computer loads the system and prints a message similar to the following: 

TX990 SYSTEM RELEASE 2.2 

MEMORY SIZE(WORDS) : 24576 AVAILABLE: 16749 

6. Enter an exclamation point (!) at the keyboard ol the system console. The computer 
prints the following: 

TXDS 936215 ** 1/0 0:0 

PROGRAM: 

7. Enter the following information to execute utility SYSUTL to initialize the time and 
date. Terminate each line with a carriage return. The example shows entering data 
corresponding to 2:15 PM April 1, 1977. 

PROGRAM: :SYSUTL/SYS 

INPUT: 

OUTPUT: 

OPTIONS: ID, 1977, 4,1,14, 15. 
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8. SYSUTL executes the command, printing the following message, and returning control 
to TXDS: 


TX990 SYSTEM UTILITY 937544** 

14: 15:010 APR 1, 1977 

9. Enter the following information to execute utility TXCCAT to copy object code of 
the TXDS control program to the TX990 parts diskette. 

PROGRAM: :TXCCAT/SYS 

INPUT: :CNTR0L/0BJ 

OUTPUT: DSC2:CNTR0L/0BJ 

OPTIONS: *N0 OPTIONS 


10. Remove the TXDS system diskette from the left hand floppy disc unit, and place the 
scratch diskette on which the new system is to be written in the left hand unit. 

11. Enter the following information to execute utility INITDSC to initialize the new 
system diskette: 

PROGRAM: : INITDSC/SYS* 

TX990 DISC INITIALIZATION 937545 ** 

DISC NAME? DSC 

DISC I.D.? TXDS SYSTEM DISC 

Ok TO 'ErA'S'e disc ?? y or n y 

CHECKING DSC 
INITIALIZATION COMPLETE 


1 2. Enter the following information to execute utility GENTX to generate source code for 
system modules TASKDF and TXDATA: 

PROGRAM: :GENTX/SYS* 

13. GENTX requests parameters as follows. Enter the values shown. Where no value is 
shown, the default applies. A carriage return terminates each line. A value other than 
the default may be entered if required. 

TX990 SYSTEM GENERATION 945673 *C 

MEMORY AVAILABLE - 2000 

LINE FREQ. - 

TIME SLICE - 

Pl~0 WT. FACTOR - 

PL~ 1 WT. FACTOR^ 

PI 2 WT. FACTOR - 
PL 3 WT. FACTOR - 
COMMON SIZE - 170 

# OF EXP CHASSIS - 
CHASSIS - 0 

DEV NAME - LOG 


Change 1 
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14. Define the system console. When the system console is a 913 VDT, perform this step, 
and skip to step 17. 


DEV TYPE - V913 

STATION # - 1 

CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 

15. When the system console is a 91 1 Video Display Terminal, perform this step and skip to 
step 17. 

DEV TYPE - V91 1 
STATION # - 1 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 


16. When the system console is a 733 ASR Data Terminal, perform this step. 

DEV TYPE - ASR 

LEFT CASS/PTP NAME - CS1 

RIGHT CASS/PTR NAME - CS2 

CRU BASE ADDR - 

ACCESS MODE - 

INT LEVEL - 

TIME-OUT COUNT - 

17. When one or more 913 VDTs other than the system console is required, enter an 
appropriate device name and the information requested in step 14 for each. When one 
or more 911 VDTs other than the system console is required, enter an appropriate 
device name and the information requested in step 15 for each. When one or more 
733 ASR Data Terminals other than the system console is required, enter an appropriate 
device name and the information requested in step 16 for each. 

1 8. Enter the following information to define other devices. Omit any that do not apply. 

DEV NAME - DSC * FOR FLOPPY DISC UNIT 


DEV TYPE - FD 


CRU BASE ADDR - 


INT LEVEL - 


# OF DRIVES - 2 

* ENTER NUMBER OF DRIVES (MAX 4) 

DEV NAME - LP 

* FOR LINE PRINTER 

DEV TYPE - LP 


CRU BASE ADDR - >60 


ACCESS MODE - 


INT LEVEL - 

* FOR 913 VDT SYSTEM, ENTER 4. 

TIME-OUT COUNT - 

OTHERWISE, USE THE DEFAULT VALUE 
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DEV NAME - TTY * FOR TELETYPEWRITER 

DEV TYPE - TTY 

LEFT CASS/PTP NAME - PTP 

RIGHT CASS/PRT NAME - PTR 

CRU BASE ADDR - 

ACCESS MODE - 

INT LEVEL - 

TIME-OUT COUNT - 


19. Enter the following information to define emulator and trace modules. 


DEV NAME - EMU 
DEV TYPE - EMU 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 


* FOR EMULATOR MODULE 


* FOR 913 VDT SYSTEM, ENTER 4. 
OTHERWISE, USE THE DEFAULT VALUE. 


DEV NAME - TRA 
DEV TYPE - TRA 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 


* FOR TRACE MODULE 


* FOR 913 VDT SYSTEM, ENTER 4. 
OTHERWISE, USE THE DEFAULT VALUE. 


20. Enter the following carriage returns to terminate the device definition portion of 
GENTX: 


DEV NAME - 
CHASSIS - 


* NO MORE DEVICES 

* NO MORE CHASSIS 


21. Enter the following information to define the standard TXDS tasks: 
SVC # - 


XOP # - 

TASK ID# - >F 0 


* NO USER DEFINED SUPERVISOR CALLS 

* NO USER DEFINED EXTENDED OPERATIONS 

* FOR FLOPPY DISC DRIVE 1 


PRIORITY LEVEL - fif 
INITIAL DATA LABEL - FMP1 

TASK ID# - >F1 * FOR FLOPPY DISC DRIVE 2 

PRIORITY LEVEL - 0 


INITIAL DATA LABEL - FMP2 


22. When more than two floppy disk drives are required, repeat the floppy disk drive sequence 
for each additional drive. The task I D for the third disk drive is F2i6 and the initial data label 
is FMP3. The task ID for the fourth disk drive is F3i6 and the initial data label is FMP4. 
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23. Enter the following information to define additional standard TXDS tasks: 


TASK ID# - >B *FILE MANAGEMENT 

PRIORITY LEVEL - 1 

INITIAL DATA LABEL - fUR 


TASK ID# - 

>D 

★ 

DIAGNOSTIC TASK 

PRIORITY 

LEVEL - 1 



INITIAL 

DATA LABEL - 

DIAGTS 


TASK ID# - 

>F 

★ 

OCP - OMIT THIS SEQUENCE WHEN OCP IS 

PRIORITY 

LEVEL - 1 

★ 

NOT REQUIRED 

INITIAL 

DATA LABEL - 

OCP 


TASK ID# - 

>16 

★ 

TXDS CONTROL PROGRAM 

PRIORITY 

LEVEL - 1 



INITIAL 

DATA LABEL - 

CNTROL 



TASK ID# - 


NO MORE TASKS 


24. Enter the following information to complete GENTX: 


MULTIPLE DYNAMIC TASKS (Y OR N) - N 
CONSOLE DEV NAME - LOG 
DEFAULT DISC NAME - DSC 

DEFAULT PRINT DEV - LOG * NO ENTRY IF PRINT DEVICE NOT SUPPORTED 

ASSIGN LUNO - * NO PREASSIGNED LUNOS 

# OF SPARE DEV LUNO BLOCKS - 

# OF SPARE FILE LUNO BLOCKS - 

# OF FILE CONTROL BLOCKS - 

# OF DEFAULT BUFFERS - 0 

# OF GENERAL BUFFERS - 0 

TASKDF OUTPUT FILE NAME - :TASKDF/SRC 

* GENERATE SOURCE MODULE ON FILE :TASKDF/SRC 
TXDATA OUTPUT FILE NAME - :TXDATA/SRC 

* GENERATE SOURCE MODULE ON FILE -.TXDATA/SRC 


END TX990 SYSGEN 


25. Enter the following information to execute OBJMGR to select and copy modules to an 
input file for TXLINK. 

PROGRAM: :OBJMGR/SYS* 

990 OBJECT MANAGER 945672 *B 

OUTPUT FILE: :TXPART/OBJ 
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26. Select object modules from file -.DSRLIB/OBJ. Enter C for supported devices, and S for 
devices that are not supported. Selections must be consistent with devices defines in steps 
14 through 19. Selections shown are for a system that has a 91 1 VDT, a line printer, two 
floppy disk units, an emulator, and a trace module. 

INPUT FILE: DSC2 : DSRLIB/OBJ 

OPEN INPUT FILE, WITH REWIND ? Y 


FPYDSR 

? 

C 

★ 

FLOPPY DISC DSR 

DSR733 

? 

C 

* 

733 ASR DSR 

KSRDSR 

? 

s 

* 

743 KSR DSR 

LPDSR 

? 

c 

* 

LINE PRINTER DSR 

FLP 

? 

s 

* 

FAST LINE PRINTER PSR 

DSR93 

? 

s 

* 

913 VDT DSR 

CRDSR 

? 

s 

* 

CARD READER DSR 

DSRTTY 

? 

s 

★ 

TELETYPEWRITER DSR 

DSR911 

END-OF-FILE 

? 

c 

* 

911 VDT DSR 


27. Remove the TXDS parts diskette from the right-hand disk unit, and place the AMPL 
diskette in the right-hand unit. Select modules from file :AMPDSR/OBJ for emulator 
and trace module DSRs. Enter C to include a module. 

INPUT FILE: DSC2 rAMPDSR/OBJ 

OPEN INPUT FILE, WITH REWIND ? Y 

EMDSR ? C * INCLUDE FOR EMULATOR SUPPORT 

TMDSR ? C * INCLUDE FOR TRACE MODULE SUPPORT 


28. Remove the AMPL diskette from the right-hand disk unit, and place the TXDS parts 
diskette in the right-hand unit. 


29. Select all modules from file :OCPLIB/OBJ when OCP is required. Otherwise, omit this 
step. 

INPUT FILE: DSC2 :0CPLIB/0BJ 

OPEN INPUT FILE, WITH REWIND ? Y 


OCPTSK ? A * INCLUDE ENTIRE FILE 

END-OF-FILE 

30. Select modules from file FMPLIB/OBJ for floppy disk drives. Enter C to include module, 
module. 



INPUT 

FILE: 

0SC2: FMPLIB/OBJ 



OPEN 

INPUT 

‘FILE, WITH REWIND ? Y 



TXFMP1 

? 

C 




TXFMP2 

? 

C 




TXFMP3 

? 

s 

* INCLUDE 

FOR THIRD 

FLOPPY DISC DRIVE 

TXFMP4 

? 

s 

* INCLUDE 

FOR FOURTH 

FLOPPY DISC DRIVE 

TXFMP 

? 

A 

* INCLUDE 

REMAINDER 

OF FILE 

end-OF 

-FILE 
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3 1 . Select the module on file :CNTROL/OBJ and appropriate modules from file 
:TXLIB/OBJ. Enter C to include module. 

INPUT FILE : DSC2 : CNTROL/OBJ 

OPEN INPUT FILE, WITH REWIND ? Y 
CNTROL ? C ' ' 

END-OF-FILE 


INPUT FILE : DS C2 : T XL I B/OB J 

OPEN INPUT FILE, WITH REWIND ? Y 


TXROOT 

? 

C 



EVENTK 

? 

C 

*REQUI RED FOR AMPL 

TITTCM 

? 

S 



CRTPRO 

? 

C 

^INCLUDE 

TO SUPPORT EITHER VDT 

STA913 

? 

S 

♦FOR 913 

VDT SUPPORT 

SVC913 

? 

S 

♦FOR 913 

VDT SUPPORT 

STA91I 

? 

C 

♦INCLUDE 

FOR 911 SUPPORT 

SVC911 

? 

C 

♦INCLUDE 

FOR 911 SUPPORT 

IOSUPR 

? 

A 

♦INCLUDE 

REMAINDER OF FILE 

END-OF- 

FILE 





32. Respond to next request for an input file with a carriage return, terminating OBJMGR, 
as follows: 


INPUT FILE: 

END OBJECT MANAGER 


* NO MORE FILES 


33. Remove the TX990 parts diskette from the right-hand disc unit, and place the TXDS 
system diskette in the right-hand unit. (The TXDS system diskette was removed from 
the left-hand unit in step 10). 

34. Enter the following information to execute TXM1RA to assemble modules TXDATA 
and TASKDF. 

PROGRAM: :TXMIRA/SYS * ASSEMBLE TXDATA 

INPUT: .'TXDATA/ SRC 

OUTPUT: :TXDATA/OBJ, :TXDATA/LST 

OPTIONS: CLS 

TXMIRA 936227 ** 


PROGRAM: :TXMIRA/SYS * ASSEMBLE TASKDF 

INPUT: :TASKDF/SRC 

OUTPUT: :TASKDF/OBJ , :TASKDF/LST 

OPTIONS: CLS 

TXMIRA 936227 ** 
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35. Enter the following information to execute TXLINK to link the new system. 

PROGRAM: : TXLINK/SYS 

INPUT: : TXDATA/OBJ , : TASKDF/OBJ , : TXPART/OBJ 

OUTPUT: :NEWSYS/SYS, :NEWSYS/LST 

OPTIONS: CLITX990 

TXLINK 937357 ** 

36. Remove the TXDS system diskette from the right-hand floppy disc unit, and place the 
TX990 parts diskette in the right-hand unit. (The TX990 parts diskette was removed 
from the right-hand unit in step 30.) 

37. Enter the following information to execute SYSUTL to copy the system loader to the 
new system diskette and to designate the newly linked system as the current system. 

PROGRAM: :SYSUTL/SYS* 

TX990 SYSTEMS UTILITY 937544 ** 

OP: BC.DSC.SF, :NEWSYS/SYS.TE. 

38. The newly linked system may be loaded by repeating steps 2, 3, and 4. The system 
should print the initial message. Actual memory size numbers vary: 

TX990 SYSTEM RELEASE 2.2 

MEMORY SIZE(WORDS) : 24576 AVAILABLE: 14631 

39. Enter an exclamation point (!). If OCP was included in the system, OCP begins execution 
and prints a period (.) to request input. If OCP was not included, TXDS begins execution 
and prints the message shown in step 40. 

40. Enter the following to execute TXDS if OCP was included: 

^ EXJ6.TE. 

41. TXDS prints the following: 

TXDS 936215 ** 1/0 0: 0 

Should the system fail to begin execution or to execute OCP or TXDS, carefully check the 
parameters supplied to GENTX and the other input to the system generation process. If an error 
is identified, repeat the procedure correctly. 
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APPENDIX B 

DX10 SYSTEM GENERATION 


B.l INTRODUCTION 

The DX10 operating system supplied by Texas Instruments does not support the emulator and trace 
modules for an AMPL system. The user must generate a version of DX 10 that supports these modules 
as Special Devices and must install the AMPL program in the newly generated system in order to 
execute the AMPL program under DX10. System generation requires execution of the following 
system utilities: 

• SDSTIE — text editor 

• GEN990 — auto sysgen utility 

• SDSMAC — macro assembler 

• SDSLNK — link editor 

The user should have a basic knowledge of the operation of these utilities. Generating a system requires 
the following: 

• A system disk volume that contains the DX10 object modules (accessed through directory 
.SSSYSGEN). 

• The AMPL disk volume or the AMPL parts already installed on the system disk. 

• The AMPL installation package. 

The AMPL installation package may reside on the system disk volume, on a separate disk volume, 
or on magnetic tape. When the package is on magnetic tape, perform the procedures in paragraph 
B.8 to copy the package to either the system disk or to a separate disk volume, then generate the | 
system. On either medium, the installation package is defined in directory DXAMPL30. 

This appendix describes the initial steps prior to system generation, execution of the text editor to 
prepare the PDT modules, and execution of the auto sysgen utility. The appendix also describes 
preparing the generated system for execution and installation of the system as the primary system. 
Finally, this appendix describes installation of the AMPL program in the newly created system. 

B.2 INITIAL STEPS 

When the installation package is on a separate disk volume, that volume must be installed and the 
modules required for system generation must be moved to the system disk volume. In all cases, 
synonyms must be assigned and the modules required must be cataloged in directory .SSSYSGEN. 

The following procedure assumes that DX10 has been loaded and initialized, and is executing. If 
not, perform steps 1 through 19 of paragraph 5.2.2 prior to the following procedure: 

1. Mount the volume containing directory DXAMPL30 in a disk unit and place the unit 
in ready. Omit this step when the directory is already on the system disk. 
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2. Press the blank orange key (upper right of keyboard) on the Model 91 1 VDT to be used to 
input commands. If the terminal that was used to initialize DXIOis to be used, omit this step 
and skip to step 6. 

3. Verify that the UPPER CASE LOCK key is in the upper case position. 

4. Enter an exclamation point (!). When the system displays the initial menu of the System 
Command Interpreter (SCI), no log in is required and you may skip to step 6. Otherwise, the 
system diplays: 

SYSTEM COMMAND INTERPRETER— PLEASE LOG IN 
USER ID: 

PASSCODE: 

5. Enter the identifier that you have been assigned, and press the RETURN key. 

6. Enter your passcode and press the RETURN key. The system displays the initial SCI menu 
if the identifier and passcode are valid. If not, you may have entered the identifier or 
passcode incorrectly, or your privilege level may be too low for the terminal. Either reenter 
the identifier and passcode correctly, or use a terminal with a lower privilege level, 
respectively. If directory .DXAMPL30 already resides on the system disk skip to step 10. 

7. Enter the following command to install the disk volume: 

IV 

The system displays: 

INSTALL VOLUME 
UNIT NAME: 

VOLUME NAME: 

8. Enter the device name of the disk unit in which the AM PL disk volume was mounted; e.g., 
DS02, DS03, etc. 

9. Enter the volume name as follows: 

VOLUME NAME: DXAMPL30 

10. Enter the following command to assign a synonym for the system disk volume: 

AS 

The system displays: 

ASSIGN SYNONYM VALUE 
SYNONYM: 

VALUE: 
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1 1. Enter the synonym as follows: 

SYNONYM:DSC 

12. Enter the volume name of the system disk volume as the value. 

13. Enter AS to assign a synonym to DXAMPL30. The display is shown in step 10. 

14. Enter the synonym as follows: 

SYNONYM: AMPL 

1 5. Enter the value as follows: 

VALUE: DXAMPL30 (If AMPL parts are on a separate disk) 

VALUE: .DXAMPL30 (If AMPL parts are on the system disk) 

16. Enter the following command to execute a batch procedure: 

XB 

The system displays: 

EXECUTE BATCH 
INPUT ACCESS NAME: 

LISTING ACCESS NAME: 

17. Enter the pathname of the file that contains the batch procedure, as follows: 

INPUT ACCESS NAME:AMPL.AMPL$IGP 

18. Enter the Line Printer as the listing device, as follows: 

LISTING ACCESS NAME: LP01 

The batch procedure on file AMPL. AMPLSIGL copies the AMPL software modules onto the system 
disk, cataloged in directory .SSSYSGEN. Messages output during execution of the procedure are 
printed on the line printer. 

B.3 EXECUTING TEXT EDIT 

A DX10 system requires a Peripheral Device Table (PDT) for each device supported by the system. 
The AMPL disk volume contains source code modules for two generalized PDTs, one for the emulator 
and one for the trace module. These PDTs must be made specific by placing the correct device name in 
certain source code statements and the interrupt-level-minus-one in another source code statement. 
The user executes the Text Editor to insert the correct data into the source code statements, and to copy 
the resulting source code into a source code module for the PDT for a specific device. The generalized 
emulator PDT may be edited and copied as many times as required to obtain a PDT for each emulator. 
Similarly, the generalized trace module PDT may be edited and copied for each trace module. 
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The device name of the emulator in a single-emulator laboratory is EM01, and additional emulators 
are EM02 . . . EMOn, where n is the total number of emulators. Similarly, when only one trace module 
is included, the device name is TM01. Additional trace modules are TM02 . . . TMOn, where n is the 
total number of trace modules. Device names EMnn and TMnn are also valid when more than nine 
emulators or trace modules are included. 

The interrupt level for an emulator or trace module that is installed in an expansion chassis is 
determined by the slot in the main chassis into which the CRU expander board is connected. The same 
interrupt level applies to all emulators, trace modules, or other devices m all expansion chassis 
connected to the expander. The chassis number and position number are supplied to the auto sysgen 
utility to provide for identifying the specific device on the interrupt level. The interrupt level for an 
emulator or trace module that is installed in the main chassis is determined by the slot into which it is 
installed. The interrupt-level-minus-one value is the difference obtained by subtracting one from the 
interrupt level; e.g., 12, for interrupt level 13. 

The following procedure calls the Text Editor to edit a PDT for the first or only emulator and a PDT 
for the first or only trace module. Perform the following steps: 

1. Enter the following command: 

XE 

The system displays the following: 

INITIATE TEXT EDITOR 
FILE ACCESS NAME: 

2. Enter the name of the file that contains the generalized emulator PDT, as follows: 

FILE ACCESS NAME: SSSYSGEN.PDTSEM 

3. Enter the following command to replace the string ?I with the interrupt-level-minus-one: 

RS 

The Text Editor displays the following: 

REPLACE STRING 

NUMBER OF OCCURRENCES: 1 
START COLUMN: 1 
END COLUMN: 80 
STRING: 

CHANGE: 

4. Press the TAB key to enter the displayed number of occurrences. 
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5. Enter the number of the first column of the field in which ?I occurs: 
START COLUMN: 13 


6. Enter the number of the last column of the field in which ?I occurs: 

END COLUMN: 20 

7. Enter the characters of the string to be replaced: 

STRING: ?I 

8. Enter the value of interrupt-level-minus-one; the following value applies to interrupt level 
13: 

CHANGE: 12 

9. The Text Editor executes the command and displays the line in which ?I is replaced, as 
follows: 

9 DATA 12 R2 = STATUS FLG/ INTERRUPT- 1 

10. Enter the following command to terminate the edit operation and create the file specifically 
forEMOl: 

QE 

The Text Editor displays the following: 

QUIT EDIT 

ABORT?: NO 

1 1. Press the TAB key to enter the displayed response: 

The Text Editor displays the following: 

QUIT EDIT 

OUTPUT FILE ACCESS NAME: SSSYSGEN.PDTSEM 

REPLACE?: NO 

MOD LIST ACCESS NAME: 

12. Enter the name of the PDT file for EM01 as follows: 

OUTPUT FILE ACCESS NAME: ,S$SYSGEN.PDT$EM01 

13. Press the TAB key to enter the displayed NO response. 

14. Press the RETURN key to execute the command. 
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15. Enter the following command: 


XE 

The system display is shown in step 1. 

16. Enter the name of the file that contains the generalized trace module PDT, as follows: 

FILE ACCESS NAME: S$SYSGEN.PDT$TM 

17. Enter the following command to replace the string ?1 with the intemipt-level-minus-one: 

RS 

The Text Editor display is shown in step 3. 

18. Enter the number of occurrences of ?I as follows: 

NUMBER OF OCCURRENCES: 1 

19. Enter the number of the first column of the field in which ?I occurs: 

START COLUMN: 13 

20. Enter the number of the last column of the field in which ?I occurs: 

END COLUMN: 20 

21. Enter the characters of the string to be replaced: 

STRING: ?I 

22. Enter the value of interrupt-level-minus-one; the following value applies to interrupt level 
13: 

CHANGE: 12 

23. The Text Editor executes the command and displays the line in which ?I is replaced, as 
follows: 

9 DATA 12 R2 = STATUS FLG/ INTERRUPT- 1 

24. Enter the following command to terminate the edit operation and create the file specifically 
forTMOl: 

QE 

The Text Editor display is shown in step 11. 

25. Press the TAB key to enter the displayed output file access name. 

26. Press the TAB key to enter the displayed NO response. 

27. Press the RETURN key to execute the command. 
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The preceding procedure does not alter the device name; the device name in .S&S YSGEN.PDTJEM is 
EM01 and the device name in .S&SYSGEN.PDTSTM is TM01. For additional emulators and trace 
modules, perform the following steps: 

1. Perform steps 1 and 2 of the preceding procedure. 

2. Enter the following command to replace the string EM01 with the device name of an 
additional emulator: 

RS 

The system display is shown in step 3 of the preceding procedure. 

3. Enter the number of occurrences of EM01 as follows: 

NUMBER OF OCCURRENCES: 7 

4. Enter the number of the first column in which EM01 appears in any source statement: 

START COLUMN: 1 

5. Enter the number of the last column in which EM01 appears in any source statement: 

END COLUMN: 25 

6. Enter the characters of the string to be replaced: 

STRING: EM01 

7. Enter the device name of an additional emulator. The example applies to the second 
emulator: 

CHANGE: EM02 

8. The Text Editor executes the command and displays the last line in which EMO 1 is replaced, 
as follows: 

41 PLEM02 EQU S-PSEM02 LENGTH OF PDT 

9. Enter the following command to return to the beginning of the file: 

SL 

The Text Editor displays the following: 

SHOW LINE 
LINE: 1 

10. Press the TAB key to enter the displayed line number in preparation for another Replace 
String command. 

11. Perform steps 3 through 16 of the preceding procedure. 
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1 2. Enter the following command to replace string TMO 1 with the device name of an additional 
trace module: 

RS 

13. Enter the number of occurrences of TM01 as follows: 

NUMBER OF OCCURRENCES: 7 

14. Enter the number of the first column in which TM01 appears in any source statement: 

START COLUMN: 1 

15. Enter the number of the last column in which TM01 appears in any source statement: 

END COLUMN: 25 

16. Enter the characters of the string to be replaced: 

STRING: TM01 

17. Enter the device name of an additional trace module. The example applies to the second 
emulator: 

CHANGE: TM02 

1 8. The Text Editor executes the command and displays the last line in which TMO 1 is replaced, 
as follows: 

41 PLTM02 EQU S-PSTM02 LENGTH OF PDT 

19. Enter the following command to return to the beginning of the file: 

SL 

The Text Editor display is shown in step 9. 

20. Press the TAB key to enter the displayed line number. 

21. Perform steps 17 through 27 of the preceding procedure. 

22. Repeat this procedure for each additional emulator and trace module, using the proper 
device names. 

B.4 EXECUTING GEN990 

GEN990, the auto sysgen utility, builds a source code file for the operating system data base and a 
control file for the linking operation from responses supplied by the user. GEN990 displays requests 
for system parameters, and accepts commands that support the input of the required data. An 
important capability of GEN990 is that of displaying two levels of description for most of the requested 
parameters. 
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GEN990 processes the emulator and trace module as special devices. The responses shown in the 
example for these devices are required for support of these devices. The other responses are typical; the 
devices specified are those of a recommended AMPL system. An actual DX10 system may support 
other devices and/or additional devices. Similarly, other parameters may require different values in a 
system, to meet the requirements of specific applications. 

The following procedure calls and executes GEN990 to generate a DX10 system that supports an 
AMPL laboratory: 

1. Enter the following command to activate GEN990: 

XGEN 

The system displays the following: 

EXECUTE AUTO SYSGEN 


= = = = = = = = = = = = = = GEN990-AUTO SYSGEN RELEASE 3.1 ** = = -- = = = = = 

2. Enter the indicated responses to the requests displayed. For further information about the 
parameters, refer to Model 990 Computer DX10 Operating System Release 3 Reference 
Manual Vol. 5. Notice that the default values are shown in parenthesis in each 
prompt. Specify the initial system parameters as follows: 

DATA DISK: (DS01) 

TARGET DISK: (DS01) 

INPUT: 

OUTPUT: SYS1 
LINE: (60) 

SLICE: (50) 

QUEUE 0: (10) 255 
QUEUE 1: (10) 255 
QUEUE 2: (10) 255 
QUEUE 3: (10) 255 

TABLE: 6000 See note 

COMMON: (NONE) 

INTERRUPT DECODER: (NONE) 

FILE MANAGEMENT TASKS: (2) 

CLOCK: (5) 

ID: (NONE) 

OVERLAYS: (2) 

SYSLOG: (6) 

BUFFER MANAGEMENT: (IK) 

I/O BUFFERS: (0) 1152 See note 

INTERTASK: (100) 

KIF? (YES) NO 

SCI BACKGROUND: (2) 

SCI FOREGROUND: (8) 

BREAKPOINT: (16) 

CARD 1: 10 
CARD 2: 
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NOTE 

The values shown for the TABLE response and for the I/O 
BUFFERS are typical, but may not be adequate for systems with 
many peripherals or systems with multiple emulator and trace 
modules. The value for TABLE may be estimated using the informa- 
tion displayed when the WHAT? command is entered the second 
time. The value for I/O BUFFERS allows 512 bytes for an emulator 
module and 640 words for a trace module. This may be adequate for 
multiple emulators and trace modules when contention for buffer 
space is rare (e.g., concurrent use of more than one emulator and 
trace module is infrequent). 


3. Enter the following responses to define the supported devices: 


DEVICE: DS 
TILINE: (F800) 

DRIVES: (1) 2 

DEFAULT RECORD SIZE: (864) 
INTERRUPT: (13) 

DEVICE: LP 
CRU: ()60) 

ACCESS TYPE: (FILE) 

TIME OUT: (30) 0 
WIDTH: (80) 132 
PRINT MODE: (SERIAL) 
EXTENDED? (NO) YES 
3270 CRU ADDRESS: (NONE) 
INTERRUPT: (14) 

DEVICE: ASR 
CRU: ()00) 

ACCESS TYPE: (RECORD) 

TIME OUT: (0) 

CASSETTE ACCESS TYPE: (FILE) 
CASSETTE TIME OUT: (3) 
CHARACTER QUEUE: (6) 
INTERRUPT: (6) 

DEVICE: CRT 
CRU: ()C0) >0500 
ACCESS TYPE. (RECORD) 

TIME OUT: (0) 

CRT TYPE: (913) 911 
3270 CRU ADDRESS: (NONE) 
CHARACTER QUEUE: (6) 
INTERRUPT: (11) 10 
EXPANSION CHASSIS: (1) 
EXPANSION POSITION: 3 


Define the disk controller 


Define the line printer 


Define the 733 ASR data terminal 


Define 911 VDT 
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4. Enter the following responses to define the emulator and trace modules; 

DEVICE; SD Define emulator 

CRU: Q20) >0440 
INTERRUPT CRU BIT: (NA) 

NAME: EM01 
KSB: (NONE) 

DSR WORKSPACE: PDEM01 
INTERRUPT ENTRY: EMINT 
PDT FILE: ,S$SYSGEN.PDT$EM01 
DSR FILE: .SSSYSGEN.DSRSEM 
OVERRIDE? (YES) 

INTERRUPT: (15) 10 
EXPANSION CHASSIS: (1) 

EXPANSION POSITION: 1 

DEVICE: SD 

CRU: ()20) >0400 Define trace module 

INTERRUPT CRU BIT: (NA) 

NAME: TM01 
KSB: (NONE) 

DSR WORKSPACE: PDTM01 
INTERRUPT ENTRY: TMINT 
PDT FILE: .SSSYSGEN.PDTSTM01 
DSR FILE: .SSSYSGEN.DSRSTM 
OVERRIDE? (YES) 

INTERRUPT: (15) 10 
EXPANSION CHASSIS: (1) 

EXPANSION POSITION: 2 

5. Repeat the entries of step 4 (with appropriate CRU addresses, names, DSR workspaces, and 
PDT files) for additional emulators and trace modules as required. 

6. Enter the following response to complete the input to GEN990: 

DEVICE: No more devices 

SVC: No user-supplied supervisor calls 

XOP: No user-supplied XOPs 

7. Enter the following responses to terminate GEN990: 

CONFIGURATION FILE IS COMPLETE. DO YOU WANT TO SAVE IT? (YES) 

********** CONFIGURATION FILE SAVED ********** 

******** DSDATA SOURCE FILE IS NOW BEING BUILT ********** 

******** THE SDSLED COMMAND STREAM SOURCE FILE IS BEING BUILT ******* 

******** BATCH FILE FOR SYSGEN COMPLETION IS NOW BEING BUILT ******* 

8. GEN990 displays the following question. If the user enters Y instead of N as shown in the 
following example, GEN990 displays detailed instructions for assembling DSD AT A and 
linking the system. If the terminal which called GEN990 is a 733 ASR, GEN990 prints a 
convenient set of instructions. 

DO YOU NEED INSTRUCTIONS TO COMPLETE THE SYSGEN? NO 
********* GEN990 TERMINATED ********* 


Change 1 


B-l 1 


Digital Systems Division 


946244-9701 


B.5 COMPLETING SYSTEM GENERATION 

The data base for the system must be assembled and linked with the remainder of the system. 
GEN990 has created a batch stream to assemble and link the system. The ALGS procedure may be 
called to bid this batch stream. 


Prompt 

TARGET DISK: 
SYSTEM NAME: 
DSDATA LISTING: 
BATCH LISTING: 

where 


Response 

(target) 

(output) 

(user defined) 
(user defined) 


(target) = target disk specified in sysgen 
(output) = output parameter definition 

When this batch stream completes without any errors, the message ***ALGS - NORMAL 
COMPLETION *** appears on the screen. If any other message appears, an error has occurred and 
the batch listing should be examined to determine the cause of the error. 

After the system is linked, the patch stream must be run against the linked image. To patch the 
system, bid the PGS procedure. 


Prompt 

TARGET DISK: 
SYSTEM NAME: 
BATCH LISTING: 


Response 

(target) 

(output) 

(user defined) 


When the batch stream is completed without errors, the message *** PGS - NORMAL TERMI- 
NATION *** appears on the screen. If any other message appears, an error has occurred and the 
batch listing should be examined to determine the cause of the error. 


B.6 INSTALLING AND TESTING THE SYSTEM 

When the batch commands have been executed, generation of the system is complete, and it is ready 
to be installed as the secondary system for test purposes. To set up this system to be tested at IPL 
time, bid the TGS procedure. 

Prompt Response 

TARGET DISK: (target) 

SYSTEM NAME: (output) 

After the procedure is entered, it displays the system IPL status. The system name should be the 
secondary system and the IPL status should say TEST SECONDARY SYSTEM. 

The system can now be booted so that the new system can be tested. Verify that the new system is 
acceptable. If it is not, the system can be booted and control returns to the original system. 
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Perforin the procedure in paragraph 5.2.2 to load the newly generated system. Execute the Hardware 
Demonstration Test to verify system operation. If it is not possible to load the system or to perform 
the test properly, verify the system generation. When the system is acceptable, it may be installed as 
the primary system by bidding the 1GS procedure. 


Prompt 


Response 


TARGET DISK: (target) 

SYSTEM NAME: (output) 


After the procedure is entered, it displays the current IPL status. The system specified should be the 
primary system and the IPL status should be set to IPL the primary system. The sysgen is then 
complete. 

B.7 INSTALLING THE AMPL PROGRAM 

In order to conveniently execute the AM PL program under a DX 10 system, the SCI command AMPL 
must be defined, the software must be installed, the error text file must be installed, and the AMPL 
menu must be installed. The AMPL software disk volume contains these items and a set ol SCI batch 
commands to install them in the system. If this procedure is not beingdone following generation ot the 
DX 10 system that supports an AMPL laboratory, perform steps I through 15 ol the procedure in 
paragraph B.2 prior to the following procedure. Then perform the following steps: 

1. Check that program file ,S$SDS$ is not protected. This is the program file 
on which the AMPL task and procedure are to be installed. 

2. Enter the following command to assign a synonym to the system program tile: 

AS 

The system displays: 

ASSIGN SYNONYM VALUE 
SYNONYM: 

VALUE: 

3. Enter the synonym as follows: 

SYNONYM: PROGE 

4. Enter the pathname of the program file as the value: 

VALUE: . SSSDSS 

5. Enter the following command to execute the batch commands: 

XB 

The system displays: 

EXECUTE BATCH 
INPUT ACCESS NAME: 

LISTING ACCESS NAME: 
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6. Enter the pathname of the file that contains the batch commands, as follows: 

INPUT ACCESS NAME: AMPL.AMPLSIAT 

7. Enter the Line Printer as the listing device, as follows: 

LISTING ACCESS NAME: LP01 

When the execution of the batch commands completes, the AM PL laboratory is installed in the DX 10 
system. 

The AMPL software installed by the preceding procedure includes an SCI command, AMPL, that is 
executed to call the AMPL program. The command requests the user to specify the amount of memory 
in 1 K word (2K. byte) blocks, and provides a default value of 8 forBK words (16K bytes). The user may 
change the default value to any number from 1 through 32 ( 1 K through 32K words, or 2 K through 64 K 
bytes) by performing the following steps: 

1. Enter the following command to activate the Text Editor: 

XE 

The system displays the following: 

INITIATE TEXT EDITOR 
FILE ACCESS NAME: 

2. Enter the pathname of the AMPL SCI command file, as follows: 

FILE ACCESS NAME: SSPROC.AMPL 

3. When the Text Editor displays the cbmmand, position the cursor oh the following line: 

USER MEMORY (K) = INT (8) 

4. Move the cursor to the number in parentheses (8 originally) following the keyword INT, and 
enter the desired number. The following example shows the contents of the line for a default 
value of 10: 

USER MEMORY (K) = INT (10) 

5. Press the CMD key and enter the following command: 

QE 

The Text Editor displays the following: 

QUIT EDIT 

ABORT?: NO 
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6. Press the TAB key to enter the NO response. 


The Text Editor displays the following: 

QUIT EDIT 

OUTPUT FILE ACCESS NAME: SSPROC.AMPL' 

REPLACE?: NO 

MOD LIST ACCESS NAME: 

7. Press the TAB key to specify the input file for output. 

8. Enter YES to specify replacing the old file with the edited file: 

REPLACE?: YES 

9. Press the RETURN key to execute the command. 

Subsequent executions of the AM PL SCI command display the newly entered default value for 
memory size. 

After the AMPL Laboratory has been installed, and the memory size default value changed if 
necessary, synonyms AMPL, DSC, and PROGF may be deleted. To delete synonym AMPL, perform 
the following steps: 

1. Enter the following command: 

AS 

The system displays: 

ASSIGN SYNONYM VALUE 
SYNONYM: 

VALUE: 

2. Enter the synonym as follows: 

SYNONYM: AMPL 

3. Press the TAB key to enter blanks for the value, deleting the synonym. 

4. Repeat the preceding steps to delete synonyms DSC and PROGF. 
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B.8 DX10 SYSTEM GENERATION AND AMPL PROGRAM INSTALLATION FROM 
MAGNETIC TAPE 

When the AMPL software is supplied on magnetic tape, the software may be copied to a disk volume. 
The disk volume may then be used in system generation and in AMPL program installation as 
previously described for software supplied on a disk volume. To copy the software, which is listed in 
directory DXAMPL30, perform the following steps: 


1. Mount the magnetic tape that contains the installation package on an available magnetic 
tape unit and place the unit in ready. 

2. If the system disk is not to be used for the disk files to be written, install the scratch secondary 
disk in a disk unit. 


3. Enter the following command to assign a synonym to the file to be written: 


AS 


The system displays: 

ASSIGN SYNONYM VALUE 
SYNONYM: 

VALUE: 

4. Enter the synonym as follows: 

SYNONYM. AMPL 

5. Enter the value, consisting of the disk volume name concatenated with the directory name 
DXAMPL30. The volume name used in the following example is VSYS: 

VALUE: VSYS.DXAMPL30 

6. Enter the following command to copy the file from tape to disk: 

RD 

The system displays the following: 


RESTORE DIRECTORY 
SEQUENTIAL ACCESS NAME: 

DIRECTORY PATHNAME: 

LISTING ACCESS NAME: 

OPTIONS: 

7. Enter the device name of the magnetic tape unit on which the tape was mounted. The 
example uses device name MT01, as follows: 


SEQUENTIAL ACCESS NAME: MT01 
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8. Enter the directory pathname as follows: 


DIRECTORY PATHNAME: AMPL 

9. Press the TAB key to enter the default value for the listing access name. 

10. Enter the option as follows: 

OPTIONS: ADD 

1 1 . Perform the steps of system generation and program installation using the files copied to the 
disk. Do not assign a new value to synonym AMPL. 

The user may either retain the files on the disk or delete it. To delete the files perform the following 
steps: 

1. Enter the following command to delete the file directory: 

DD 

The system displays the following: 

DELETE DIRECTORY: 

PATHNAME: 

LISTING ACCESS NAME: 

ARE YOU SURE?: 

2. Enter AMPL as the pathname, as follows: 

PATHNAME: AMPL 

3. Press the TAB key to enter the default value for the listing access name. 

4. Enter YES to cause the directory and files to be deleted, as follows: 

ARE YOU SURE?: YES 

If the files are to remain on the disk, perform the third procedure in paragraph B.7 to delete the | 
synonyms. 
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APPENDIX C 


AMPL GRAMMAR 


The following is a formal definition of the AMPL grammar. An arrow in a statement means 
“consists of’. A vertical line on a subsequent line of a statement means “or”. Words in upper 
case letters are entered as shown. Words in lower case letters enclosed in angle brackets are 
defined in grammar statements. Words in lower case letters that are not enclosed in angle 
brackets are defined in the note that follows the grammar definition. 


<amp!prog> 


-> <stmt> 

I PROC <procname> 
1 PROC <procname> 
I FUNC <funcname> 
I FUNC <funcname> 


<parml ist> <stmt> 
<stmt> 

<parmlist> <stmt> 
<stmt> 


<procname> -* <procname> 
I name 

<funcname> -> <funcname> 
I name 


<parmlist> -> (constant, constant) 
! (constant) 


<stmt> -> BEGIN <stmtlist> END 
I IF <expr> THEN <stmt> 

1 IF <expr> THEN <stmt> ELSE <stmt> 

! WHILE <expr> DO <stmt> 

! REPEAT <stmt> UNTIL <expr> 

1 CASE <expr> OF <caselist> ELSE <stmt> 

1 CASE <expr> OF <caselist> 

1 FOR <leftpart> = <expr> TO <expr> BY <expr> DO < stmt > 
j FOR <Ieftpart> = <expr> TO <expr> DO < stmt > 
i <proccall> 

l<procca!I> (<arg1ist>) 

! RETURN 

I RETURN <expr> 

! <assign> 
i <display> 

I NULL 
1 <stmt>; 

| ARRAY <arraylist> 

I ESCAPE 


<stmtl ist>-> < stmt! ist > ; < stmt> 
i <stmt> 


<proccall> + <procname> 
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<array1ist> -* <array1ist>, <arrayname> <exprlist> 
| <arrayname> <exprlist> 

<arrayname> <arrayname> 

| name 

<caselist> <expr>: :<stmt> 

I<case1ist> <expr ::<stmt> 

<assign> -> <left part> = <expr> 

<left part> -> symbol 

I @ < primary> 

I undefined 
i<arrayname> 
l<arrayname> <exprlist> 

<display> -> string 
I <expr> 

l<expr>: format 
I <expr>? 

I<expr>: format ? 

) <expr>: format ? :<format> 
l <range>? 

I <range>: format ? 
l<range>: format ? : format 

<range> -> <expr> TO <expr> 

<exprlist> -> (<expr>) 

| (<expr>,<expr>) 

<expr> -> <expr> OR <expr> 
i <expr> AND <expr> 

I NOT <expr> 

I <expr> relop <expr> 
i <expr> addop <expr> 

I <expr> multop <expr> 

I <primary> 

<primary> -> (<expr>) 
i symbol 
I constant 
I @ <primary> 

I addop <primary> 

I <funccall> 

i<funccall> (<arglist>) 

I <arrayname> <exprlist> 

<funccall> -* <funcname> 

<arglist> <arglist>,<expr> 

i <arglist>,<string> 
i <expr> 

I string 
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Note: The items in the grammar definition that are not defined in the statements of the definition 
are as follows: 

addop — The addition or subtraction operator; i.e., + or — . 
constant — A constant. 

format - A format specification consisting of one or more of the format characters in 
table 2-2. 

multop — The multiplication or division operator; i.e., *,/, or MOD. 

name — A user symbol that is a procedure, function, or array name. 

relop - A relational operator; i.e., EQ, GE, GT, HI, HIE, LE, LO, LOE, LT, or NE. 

string — A character string. 

symbol — A user symbol or variable. 

undefined — A user symbol or variable not previously defined. 
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APPENDIX D 

AMPL STATEMENT SUMMARY 

The statements of AMPL language with the syntax for each statement are as follows: 
ARRAY statement: 

ARRAYtf<array name>(<expr>[,<expr>])[,<array name>(<expr>[,<expr>])]. . . 
Assign statement: 

< symbol > = <expression> 

CASE statement: 

CASE0<expr>0OF$<expr> : : <s tmt> ; [<expr> : :<stmt>;]. . . [|z5ELSE|6<s tmt> ]fe5END 
Compound statement: 

BEGINb<statement>[[;]<statement>]. . .(SEND 
Display statement: 

<addh>[0TO|6<addr>][:<format>. . . ][?[ :<format>. . .]] 

ESCAPE statement: 

ESCAPE 

FOR statement: 

FOR|6<symbol>=<expr>16TO0<expr>[0BY0<expr>]|riDO|6<stmt> 

FUNC statement: 

FUNCfekf unction name>[(<parml>[,<parm2>])]<statement> 

IF statement: 

IF<expression>0THEN0<statement>[>ELSE|!5<statement>] 

NULL statement: 

NULL 

PROC statement: 

PROQkprocedure name>[ (<parml >[ ,<parm2>]) ]<statement> 
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REPEAT statement: 

REPEAT0<statement>$UNTIH5<expression> 

RETURN statement: 

RETURN[|6<expression>] 

WHILE statement 

WH I LEJkexpres s i on>tfD0tks tatemen t> 
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APPENDIX E 

AMPL RESERVED WORDS 


The following are the reserved words of the AMPL language: 

AND 

ARG 

ARRAY 

BEGIN 

BY 

CASE 

DO 

ELSE 

END 

EQ 

ESCAPE 

FOR 

FUNC 

GE 

GT 

GUBED 

HI 

HIE 

IF 

LE 

LO 

LOC 

LOE 

LT 

MOD 

NE 

NOT 

NULL 

OF 

OR 

PROC 

REPEAT 

RETURN 

THEN 

TO 

UNTIL 

WHILE 
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APPENDIX F 
SYSTEM SYMBOLS 

The following is a list of system symbols and their definitions: 

ADDR - An operand keyword used in the ECMP, ETRC, TCMP, and TTRC' commands. 

CC - A system variable that contains a running total of clock cycles. 

CRUB - A system variable that contains the CRU base address for the CRUR and CRUW com- 
mands. 

DO - D3 - Operand keywords that name high order data bits in TCMP command. 

DATA - An operand keyword used in the TCMP and TTRC commands. 

DAY - A system variable that contains the day of the year. The user may only read this variable. 
DBIN - An operand keyword used in the ECMP, TTRC, TCMP, and TTBH commands. 

DEF - An operand keyword used in the LOAD command. 

DST - A system variable that contains the destination address of an instruction being displayed in 
the instruction mode. 

EACH - An operand keyword used in the TEVT command. 

EDGE — An operand keyword used in the TEVT command. 

EMT — A system variable that identifies the type of microprocessor being emulated. The user may 
only read this variable. Values are: 

0 = TMS 9980 microprocessor 

1 = TMS 9900 microprocessor 

EMU - An operand keyword used in the TBRK, TTRC, TCMP, and TTBH commands. 

ENI - A system variable that contains the number of emulator interrupts that have occurred since 
the emulator was started, when the EBRK command specifies turning breakpoints off. The 
user may only read this variable. 

EST - A system variable that contains the current status of the emulator module. The user may 
only read this variable. 

ETBN - A system variable that contains the index of the newest address stored in trace memory 
of the emulator. The user may only read this variable. 
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ETM - A system variable that maps trace memory into target system memory addresses FEOOj 6 
through FFFFi 6 . Values are: 

0 = Target system memory 

1 = Trace memory 

EUM — A system variable that maps user memory into target system memory addresses 0 through 
lFFFj 6 . Values are: 

0 = Target system memory 

1 = User memory 

EVT — An operand keyword used in the EBRK and TBRK commands. 

EXT — An operand keyword used in the EEVT, ETRC, TEVT, and TTRC commands. 

FULL — An operand keyword used in the EBRK and TBRK commands. 

HCRB - A system variable that contains the CRU base address for the host CRU commands 
HCRR and HCRW. 

HR - A system variable that contains the hour of the day. The user may only read this variable. 

IAQ — An operand keyword used in the ECMP, ETRC, TCMP, TTRC, and TTBH commands. 

IDT — An operand keyword used in the LOAD command. 

INT — An operand keyword used in the EEVT, ETRC, TEVT, and TTRC commands. 

INV — An operand keyword used in the TEVT command. 

MC — A system variable that contains a running total of memory accesses. 

MDR - A system variable used with the MPY and DIV commands, and with addition and sub- 
traction operations in expressions. Contains the most significant 16 bits of the product 
or the remainder. Is set to one when a carry occurs in an addition or subtraction operation, 
and to zero when a carry does not occur in an addition or subtraction. The user places the 
most significent 16 bits of the dividend in MDR for a division operation. 

MIN - A system variable that contains the minute of the hour. The user may only read this 
variable. 

NORM — An operand keyword used in the TEVT command. 

OFF — An operand keyword used in the EBRK, ECMP, ETRC, TBRK, TCMP, and TTRC com- 
mands. May also be used in an assign statement to assign the value of zero to a variable. 

ON - An operand keyword in the TTRC command. May also be used in an assign statement to 
assign the value of one to a variable. 
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PC - A system variable that contains the value in the target system program counter. 


Q0 — Operand keyword used in emulation control and data mode to specify odd address selection 
for the TMS 9980 microprocessor. 

Q0-Q3 - Operand keywords that name qualifier bits in the TTRC command. 

R0-R15 — System variables that contain the values in the target system workspace registers. 

REF - An operand keyword used in the LOAD command. 

SEC - A system variable that contains the second of the hour. The user may only read this variable 
variable. 


SELF - An operand keyword used in the EBRK and TBRK commands. 

SRC — A system variable that contains the source address of an instruction being displayed in the 
instruction mode. 


ST - A system variable that contains the value in the target system Status Register. 


TIME 


A system variable used as a switch to control printing of instruction time counts when 
data is displayed in the instruction mode. 


TNE A system variable that contains the number of trace module events that have occurred 
since the module was started. The user may only read this variable. 

TNI — A system variable that contains the number of trace module interrupts that have occurred 
since the module was started. The user may only read this variable. 

TST - A system variable that contains the current status of the trace module. The user may only 
read this variable. 

TTBN — A system variable that contains the index of the newest value stored in memory of the 
trace module. The user may only read this variable. 

TTBO — A system variable that contains the index of the oldest value stored in memory of the 
trace module. The user may only read this variable. 

WP — A system variable that contains the value in the target system workspace pointer. 

YR - A system variable that contains the year. The user may only read this variable. 
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APPENDIX G 
USER COMMANDS 


The commands supported by AMPL software with the syntax for each command are as follows: 


CLR(<symbo1s>) 
CLSE ; 


! '<device name>' ) 

OFF }) 

ON ) 

COPY|<access name>)] 

CRUR(<disp1acement>,<length>) 

CRUW(<displacement>,<length>,<va1 ue>) 

DELE ( 1 <name> 1 [^' <name> ' ] . . .) 

DI V ( <di visor>,<di vidend>) 

DR; 


DUMP ('<access name>’ ,<start>,<end>[,<entry>]) 

! addr ) 

[flDDR+] D IAQ| [ ' <address> J)J 

EDIT [ ( ' access name 1 )] 

eevt [({exT}>3 


EOF; 
EHLT ; 


E I NT ( '<device name>‘) 
ERUN; 

ETB(<index>) 


G-l 


Digital Systems Division 



946244-9701 


( ADDR 

ETRC[(< [ADDR+]IAQ 
( OFF 

EXIT [('< access name> < start > , <end> [ , < entry >])] 
HCRR(<displacement>,<length>) 

HCRW(<displacement>,<length>,<va1ue>j 

('<access name> 

L I ST ( < OFF 

( ON 

LOAD( '<access name>‘ [,<bias>[,^ IDT ^ + Qpp^ +DEF ^|]]) 

MDEL; 

MPY(<mul ti pi i cand> ,<mu1 ti pi ier> ) 

MSYM; 




I 


'[,<count>[,®]])] 


NL; 


OPEN( '<access name>') 


READ; 

RSTR( '<access name>‘) 

SAVE( '<access name>'[,<start>,<end>[<entry>]] 


SSYM; 



[,<1ow 16 va1ue>[,<1ow 16 mask>]])] 


xrurr/ 4. r ^ 1 r T N 0 RM 1^ T EACH 1 + P NT 1 lin 

TEVT[(<events>[ ,<delays>[, INV + EDGE + EXT JJJJ 


THLT; 

TINT( '<device name>') 
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TRUN; 

TTB(<index>) 

TTBH(<index>, 



|_JqO |_}q! { |q2 

ji 3 ] 


( + 1 

|_j IAQ 

j + ) 

j_j DBIN 

> 

EMU ] 



H 

j_j Q0 

H 


>) 


I Q1 

[II 





USVM; 

VRFY( 1 <access name>‘ [,<bias>]) 
WAIT(<number>) 
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APPENDIX H 

AMPL PROCEDURE AND FUNCTION LIBRARY 


AM PL software includes a library of procedures and functions described in this appendix. These 
procedures and functions are stored on the AMPL system diskette (part number 937745-0001) in a set 
of 17 files. Table H-l lists the procedures and functions in the library, and the filename by which each is 
accessed. The filenames shown apply when the diskette is loaded in floppy disk unit 1. 

To use the procedure and function library, the user loads the diskette into either floppy disk unit and 
executes COPY command for each file. Floppy disk unit 1 (left-hand unit) is normally used; the 
filenames for floppy disk unit 2 begin with DSC2 instead of DSC. 

AMPL software executes the COPY command by reading the file, printing a message that identifies 
the procedure or function being defined, and storing the definition for subsequent use. When the name 
of the procedure has previously been defined as a procedure, the user may enter a DELE command to 
delete the procedure, and reenter the COPY command. Similarly, when the name of the function has 
previously been defined as a function, the user may enter a DELE command to delete the function, and 
reenter the COPY command. Any other type of name duplication (name previously defined as a 
variable or array, function name previously defined as a procedure, or procedure name previously 
defined as a function) requires that the user clear the symbol table with a CLR command, reenter the 
COPY commands previously entered, and redefine required variables, procedures, functions, and 
arrays. By entering the desired COPY commands early in the debug session, the user minimizes the 
problems of duplicate names. 

Some files contain a single procedure or function; others contain several procedure or function 
definitions. When a file contains more than one definition, a separate message identifies each 
procedure or function. Figures H-l through H-17 show the listings of the procedure and function 
library files. Each listing begins with a set of comments that describe the procedure or function and the 
syntax used to call it. 

The comments are followed by the message that identifies the procedures or function, and the AMPL 
statements that define it. 

After a file has been read and processed, the user may call the procedure or function in accordance with 
the calling information contained in the listing of the file. 

The following is an example of a COPY statement (TX990) to install procedures ESTAT and TSTAT: 

?COPY(‘DSC:STAT/ PRC’) Copy file DSC;STAT/PRC and install 

procedures ESTAT and TSTAT. 

The COPY statement to install the same procedures in a DX10 system is; 

?COPY (‘.SSSYSLIB. AMPLSLIB.STAT’) Copy file .SSSYSLIB. AMPLSLIB.STAT 

and install procedures ESTAT AND 
TSTAT. 
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The following is an example of a call to procedure ESTAT: 


? ESTAT 

EMULATOR IS EXECUTING AN IDLE INSTRUCTION. 
EMULATOR TRACE BUFFER IS NOT FULL. 

EVENT CONDITIONS ARE NOT SATISFIED. 

Q0QF BREAKPOINTS COUNTED. 


The largest file is that of the 14 debug procedures. Because of the size of this file (and the time required 
for copying it into the program) the message that describes the procedures and their use is on a separate 
file, shown in figure H-4. In a TX990 system, execute LIST80 to obtain additional copies. In a DX10 
system, execute a Print File command to obtain additional copies. 
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TITLE: HARDWARE DEMONSTRATION TEST FOR AMPL HARDWARE 

REVISION: 09/16/77 

ABSTRACT : 

THIS COPV FILE IS READ AS PART OF THE SVSTEM TEST OF 
AN AMPL HARDWARE FOR QUICK VERIFICATION THAT THE EMULATOR 
AND TRACE MODULES WORK CORRECTLV UNDER THE AMPL SOFTWARE. 


USAGE: 

THE OPERATOR PLACES THE DISKETTE OR CISC WITH THIS FILE ON 
IT INTO A DRIVE “N“ AND INVOKES AMPL. THEN HE GIVES THE 
FOLLOWING COMMAND: 

COPV < ' DSCN : AMPHDT/PRC ' > <RETURN> 

. . WHICH COPIES THIS FILE FROM A FLOPPV DISKETTE. 

OR: 

COPV< 'DS0N. S*SVSLIB. AMPL*LIB. AMPHDT ') <RETURN> 

. . WHICH COPIES THIS FILE FROM A HARD DISC. 

THE FILE DEFINES THE PROCEDURE "AMPHDT" AND INVOKES IT. 
REFER TO THE TEXT MESSAGES BELOW FOR OPERATIONAL DETAILS. 

NOTE: THIS PROCEDURE IS NOT A HARDWARE DIAGNOSTIC! 


NL; 'DEFINING PROCEDURE AMPHDT - PLEASE WAIT'; NL 


'LOCAL' PROC DEFINITION 


CLR<10> 
C = 0; 


FUNC 


MEMTST <3, 1) BEGIN 
FOR LOC 1 = ARG 1 
FOR LOC 1 = ARG 2 
IF 0LOC 1 NE 
RETURN 0 . . MEMORV 
END 


MEMORV TEST FUNCTION 
TO ARG 2 BV ARG 3 DO 0LOC 1 = 
TO ARG 1 BV - ARG 3 DO 
LOC 1 THEN RETURN -1 . . MEMORV 
OK ! 


LOC 1 
ERROR 


PROC RESET BEGIN 
PC = 0100 
WP = 0A0 
R0 = 0 
R1 = 1 
R2 = 2 
R3 = 3 
END 


. . INITIALIZE CPU REGISTERS PROCEDURE 


FUNC ETST <1, 1) BEGIN 

IF PC NE 0106 OR EST NE ARG 1 THEN RETURN -1 
IF EMT EQ 0 

THEN BEGIN . . 9980 ADDRESSES TRACED 

LOC 1 = 0105 
END/ 

ELSE BEGIN . . 9900 ADDRESSES TRACED 

LOC 1 = 0104 
END; 

IF ETBO NE -2+<EMT-l>*3 

OR ETBCETBO} NE 0100 OR ET8<ETBN> NE LOC 1 
THEN RETURN -1 
RETURN 0 
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END; 

FUNC TTST<3> BEGIN 

IF EST NE 0 OR TST NE FtRG 1 OR TTBN— TTBO+1 NE RRG 2 OR 
TTB<TTBO> NE #MOV R0, Rl# OR TTB<TTBN> NE ARG 3 
THEN RETURN -1 
RETURN 0 
END; 


PROC AMPHDT <0, 1) BEGIN 
IF C EQ 0 THEN BEGIN 

C : NX0 ' -EMULATOR INITIALIZATION TEST-'; HL 

NL; 'PLEASE INITIALIZE THE EMULATOR WITH THE COMMAND •' 

NL; ' EINT < ' 'CEMULATOR NAME> " > ' 

NL; 'THE EMULATOR NAME WILL PROBABLV BE "EMU" FOR THE' 

NL; 'TXDS OPERATING SVSTEM OR "EM01" FOR THE DX/10 3. 0 OS ' 

NL; 'IF THE INITIALIZATION SUCCEEDS CONTINUE THE TEST BV ENTERING ' 
NL; ' AMPHDT <RETURN> ' 

C = 1 
RETURN; 

END; 

IF C EQ 1 THEN BEGIN 

C : NX0; '-EMULATOR MEMORV SELECTION TEST-'; NL 

EUM=OFF 

ETM=OFF 

IF EUM NE 0 OR ETM NE 0 THEN BEGIN 

NL; '*** ERROR: MEMORV SELECTION TEST FAILS', 

RETURN 

END 

C = 2 
END; 

IF C EQ 2 THEN BEGIN 

C:NX0; '-EMULATOR USER MEMORV TEST <4K WORDS >-',NL 
EUM = ON; 

IF MEMTSTC0, >2000-32, 32 > THEN BEGIN 

C : NX0; '*** ERROR: EMULATOR USER MEMORV ERROR' 

RETURN 

END; 

. . PLACE A PROGRAM IN MEMORV 
00100 = #MOV R0, Rltt; 

00102 = #MOV Rl, R2#, 

00104 = #MOV R2, R3#; 

00106 = #IDLE#; 

C = 3; 

END; 

IF C EQ 3 THEN BEGIN 

C:NX0; '-EMULATOR TRACE BUFFER MEMORV TEST <256 WORDS >-'; NL 
ETM = ON; 

IF MEMTST<0FE00, 0FFFE, 2> THEN BEGIN 

C : NX0; '*** ERROR: EMULATOR TRACE MEMORV FAILURE' 

RETURN; 

END; 

C = 4; 

END; 

IF C EQ 4 THEN BEGIN 
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C:NX0; ' -EMULATOR RUN TEST-'; HL 

ETM » OFF 

ETRC<OFF) 

ECMP < OFF ) 

EEVTCINT) 

EBRK<OFF, OFF) 

RESET 

ERUN 

IF EST NE 9 THEN BEGIN 

C:NX0;'*** ERROR: EMULATOR EXECUTION FAILURE' 

RETURN 

END; 

C = 5 
END; 

IF C EQ 5 THEN BEGIN 

C:NX0; '-EMULATOR HALT TEST-'; NL 

LOC 1 * EHLT 

IF EST NE 0 THEN BEGIN 

C : NX0; '*•••* ERROR: EMULATOR FAILED TO HALT PROPERLV ' 

RETURN 

END; 

C * 6; 

END; 

IF C EQ 6 THEN BEGIN 

C : NX0; '-EMULATOR TRACE TEST'; NL 
ETRC<ADDR+IAQ, 3*<<NOT EMT)+2), INT); 

EBRK<FULL> SELF); 

RESET 

ERUN; 

IF ETST<2) THEN BEGIN 
LOC 1 = EHLT; 

C : NX0; '*** ERROR: EMULATOR FAILED TRACE TEST' 

RETURN; 

END; 

C = 7; 

END; 

IF C EQ 7 THEN BEGIN 

C:NX0; '-EMULATOR ADDRESS COMPARISON TEST-'; NL 
RESET; 

ECMPCIAQ, 0104); 

EEVT < INT); 

EBRK<EVT, SELF); 

ERUN; 

IF ETST <4) THEN BEGIN 
EHLT; 

C : NX0; '*** ERROR: EMULATOR FAILED PC BREAKPOINT' 

RETURN; 

END 

NL; '*** EMULATOR PASSES HARDWARE DEMONSTRATION TEST *** ' ; NL 
V = 0; N = -1; 

C : NX5; 'DO VOU WISH TO TEST A LOGIC STATE TRACE MODULE? CV-VES, N-NO) ' 
IF READ EQ 0 

THEN C = 8 
ELSE C = 14 

END; 

IF C EQ 8 THEN BEGIN 

C:NX0; '-LOGIC STATE TRACE MODULE INITIALIZATION TEST-'; NL 
NL; 'TO TEST THE AMPL LOGIC STATE TRACE MODULE IT MUST BE STRAPPED TO' 
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NL; 

NL 


NL 

NL 

NL 

NL; 

NL; 


'THE EMULATOR JUST TESTED WITH BOTH THE CONTROL AND DATA CABLES 
'PLEASE VERIFY THAT THESE CABLES ARE CONNECTED. 


NL; 'INITIALIZE THE LOGIC STATE TRACE MODULE WITH THE COMMAND: 


TINT ( ' 'CTRACE MODULE NAME> " > ' 
'THE TRACE MODULE NAME WILL PROBABLY BE 
'TXDS OPERATING SYSTEM OR 


TRA" FOR THE' 

-■ TM01" FOR THE DX/10 3. 0 OS ' 

IF THE INITIALIZATION SUCCEEDS CONTINUE THE TEST BY ENTERING 
AMPHDT <RETURN> ' 


C = 9 

RETURN; 

END; 


IF C EQ 9 THEN BEGIN 

C.NX0; '-TRACE MODULE INTERNAL CLOCK TEST-'; NL 
ECMPCOFF) PUT THE EMULHTOR IN A NEUTRAL STATE 

EEVT < I NT) 

ETRC<OFF> 

EBRK<OFF, OFF) 

TTRCCOFF, 10, I NT, OFF); 

TEVTCl, 0, 0); 

TBRK<FULL, SELF); 

TRUN; 

RESET; 

ERUN; LOC 1 = EHLT; 

IF TST NE 6 THEN BEGIN 
LOC 1 = EHLT; 

C:NX0; '*** ERROR: TRACE MODULE FAILED INTERNAL CLOCK TEST' 

RETURN 

END 

C = 10; 

END; 

IF C EQ 10 THEN BEGIN 

C:NX0; '-TRACE MODULE DATA TRACE TEST-', NL 
TTRC < DATA+ 1 AQ+ < EMT-1 ) *Q0, 3, EXT), 

TBRK<FULL, EMU) 

TRUN; 

RESET; 

EBRK (. OFF, SELF) 

ERUN; 

IF TTST <6, 3, #MOV R2, R3#) 

THEN BEGIN 

LOC 1 = EHLT; 

C:NX0;'*** ERROR: TRACE MODULE FAILED DATA TRACE' 

RETURN; 

END 

C = 11 
END; 

IF C EQ 11 THEN BEGIN 

C:NX0; '-TRACE MODULE EVENT TEST-'; NL 

TCMP < DATA-t- 1 AQ+ < EMT-1 ) *Q0, #MOV R0, Rl#, >FFFF ) 

TEVT < 1, 0) 

TBRKCEVT, EMU) 

TRUN 

RESET 

ERUN 

IF TTST <4, 1, #MOV RQ, Rl#) 

THEN BEGIN 

LOC 1 = EHLT 

C : NX0; '*** ERROR: TRACE MODULE EVENT FAILURE' 

RETURN 
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END; 

C = 12 
END 

IF C EQ 12 THEN BEGIN 

C : NX0' -TRACE MODULE: TRACE DELAY TEST-'; NL 
TEVTCl, 2) 

RESET 

TRUN 

ERUN 

IF TTST < 4, 3, #MOV R2, R3#> 

THEN BEGIN 

LOC 1 = EHLT 

C : NX0; ' *** ERROR: TRACE MODULE DELAY FAILURE' 

RETURN 

END 

C * 13 
END 

IF C EQ 13 THEN BEGIN 

NL; '**•* TRACE MODULE PASSES HARDWARE DEMONSTRATION TEST ***'; NL 

C = 14 

END; 

IF C EQ 14 THEN BEGIN 

NL; *** CONCLUSION OF AMPL HARDWARE DEMONSTRATION TEST ***'; NL 

C = 0 

END 

END 


. AMPHDT INTRODUCTION 
BEGIN 

C = 0 

C:NX0;'*** INTRODUCTION: AMPL HARDWARE DEMONSTRATION TEST ***';NL 
NL; ' AMPHDT IS AN AMPL PROCEDURE TO VERIFY THE CORRECT OPERATION' 

NL; ' OF THE EMULATOR AND LOGIC STATE TRACE MODULES. ' 

C : NX5 ' ONLY A GO/NO GO TEST IS PERFORMED. '; NL 
C.NX0;'*** THIS IS NOT A HARDWARE DIAGNOSTIC TEST ***'; NL 
C : NX5; ' TYPE C<RETURN> FOLLOWINa THE TO CONTINUE' 

C = READ 

NL; ' TO TEST THE TRACE MODULE, AN EMULATOR MUST BE PRESENT AND ' 

NL; 'CONNECTED WITH THE DATA AND CONTROL CABLES TO THE TRACE MODULE. ' 
NL; ' TO TEST THE EMULATOR, A BUFFER MODULE (EITHER THE TMS9900 ' 

NL, 'OR TMS9980> SHOULD BE CONNECTED TO THE EMULATOR MODULE. THE CLOCK' 
NL; 'SELECT SWITCH ON THE BUFFER MODULE MUST BE SET TO "INTERNAL". ' 

NL; 'THE TARGET MICROPROCESSOR CONNECTOR CABLES FROM THE' 

NL; 'BUFFER MODULE SHOULD NOT BE PLUGGED INTO A TARGET SYSTEM. ' 

NL; 'REFER TO SECTION 2. 2. 3 OF THE AMPL SYSTEM OPERATION GUIDE' 

NL; '< #946244-9701 > FOR DETAILS OF THESE CONNECTIONS. ' 

C : NX5; 'TYPE CCRETURN> FOLLOWING THE ,, =?” TO CONTINUE' 

C = READ 

NL, ' THE TITLE OF EACH TEST IS PRINTED AS IT IS PERFORMED. ' 

NL; 'FAILURE OF THE TEST WILL RESULT IF AMPL DETECTS AN ERROR' 

NL; OR INCORRECT RESULTS ARE DETECTED BY THE TEST PROCEDURE. ' 

NL; 'IN EITHER CASE A MESSAGE WILL BE PRINTED AND THE TEST ABORTED. ' 

NL; 'YOU MAY RETRY THE TEST THAT JUST FAILED BY ENTERING:' 

NL; ' AMPHDT <RETURN> ..FOLLOWING 

NL, 'THE COMPLETE TEST PASSES ONLY IF NO ERRORS ARE' DETECTED 
C : NX5; 'TYPE CCRETURN> FOLLOWING THE "=?" TO CONTINUE' 
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C = READ 

END 

ftMPHDT 
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. . TITLE: ASRKSR: ROUTINES TO USE AN HSR OR KSR TERMINAL 

..REVISION: 03/24/77 

RBSTRftCT 

THREE ROUTINES ARE CONTAINED IN THIS FILE. THEV INTERACT WITH 
. . EITHER AN ASR733 OR A KSR743 TERMINAL CONNECTED TO THE TARGET 
. . SYSTEM. THE INITRM PROCEDURE INITIALIZES THE INTERFACE LOGIC AT 
. . THE SPECIFIED CRU BASE ADDRESS. GETCHR AND PUTCHR READ AND WRITE 
..A SINGLE ASCII CHARACTER, RESPECTIVELY, ONCE INITRM HAS BEEN CALLED. 

. . USAGE : 

INITRM HAS ONE ARGUMENT, THE CRU BASE ADDRESS. IF THIS 
. . IS OMITTED, CRU BASE ZERO IS USED. INITRM LEAVES SYSTEM VARIABLE 
. . CRUB SET TO THE CRU BASE OF THE DEVICE, SO PUTCHR AND GETCHR CAN 
. . USE IT. INITRM MAY BE CALLED ONLY WHEN THE EMULATOR IS HALTED. 

. . GETCHR READS ONE CHARACTER FROM THE DEVICE INTERFACE AT THE BASE 
. . ADDRESS IN SYSTEM VARIABLE CRUB. GETCHR HAS NO ARGUMENTS AND 

. . RETURNS THE ASCII CODE FOR THE CHARACTER TYPED. GETCHR DOES NOT 

. . RETURN UNTIL A CHARACTER IS TYPED ON THE TERMINAL. GETCHR MAY BE 
. . CALLED ONLY WHEN THE EMULATOR IS HALTED. 

. . PUTCHR WRITES ITS ONE ARGUMENT ON THE DEVICE INTERFACE AT THE BASE 
. . . ADDRESS IN SYSTEM VARIABLE CRUB. PUTCHR IS A PROCEDURE AND DOES 

. . . NOT RETURN A VALUE. PUTCHR MAY BE CALLED ONLY WHEN THE EMULATOR 

. . . IS HALTED. 

DEFINING INITRM' 


PROC INITRMC0) BEGIN 
IF ARG 0 

THEN CRUB = ARG 1 
ELSE CRUB = 0; 

CRUWf 09, 1,1); 

CRUWC0A, 1,1); 

CRUW<0B, 1, 1), 

CRUWC0C, 1,1); 

CRUWC0E, 1,0); 

CRUWC0F, 1,0); 

END 

NL 

'DEFINING FUNCTION GETCHR' 

FUNC GETCHR <0, 1) BEGIN 

REPEAT NULL UNTIL CRURC0C, 1); 
LOC 1 = CRURCO, 8>; 

CRUWC0C, 1,1); 

RETURN LOC 1; 

END 

NL 

'DEFINING PUTCHR' 

PROC PUTCHR <1> BEGIN 

REPEAT NULL UNTIL CRURC0E, 1); 
CRUWC0, 8, ARG 1); 

REPEAT NULL UNTIL CRURC0B, 1); 
CRUWC0B, 1,1); 

END 


. BASE ADDRESS WAS SPECIFIED 
. NOT SPECIFIED 
. SET DATA TERMINAL READY 
. SET REQUEST TO SEND 
. CLEAR WRITE REQUEST 
. CLEAR READ REQUEST 
. DISABLE INTERRUPTS 
. DISABLE DIAGNOSTIC MODE 


. . . WAIT UNTIL READ REQUEST 
. . . READ THE CHARACTER 
. . . CLEAR READ REQUEST 
. . . RETURN CHARACTER 


. . . WAIT UNTIL DATA SET READY 
. . . SEND THE CHARACTER 
. . . WAIT ON WRITE REQUEST FINISHED 
. . . CLEAR WRITE REQUEST 
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TITLE: SIMPLE DEBUG COMMANDS 

REVISION: 09/27/77 

ABSTRACT : 

THIS SET OF AMPL FUNCTIONS AND PROCEDURES IMPLEMENTS 
fl SMRLL RND SIMPLE SET OF COMMRNDS FOR THE USER TO DEBUG R 
PROTOTYPE SVSTEM. THE COMMANDS ARE GROUPED INTO THREE BRSIC 
COMMAND CLASSES: 

1> EMULATION CONTROL: CLOADUP, RUN, HALT) 

LOAD MEMORY, RUN AND HALT THE EMULATOR 

2 > TARGET SVSTEM STATUS: <STRT, DR, DT) 

CURRENT EMULATION STATUS, REGISTERS AND TRACE BUFFER 

3 > TRACE/BREAKPO I NT SPECIFICATION: < TRACE, T I LL, VALUE, AT, DELAY) 

USER SELECTION OF WHAT TO TRACE AND WHEN 
TO HALT THE EMULATION 

THE USER MAY OBTAIN A LIST OF THESE COMMANDS AND THE SYNTAX FOR 
THEIR ARGUMENTS AT ANY TIME BY USE OF THE 'HELP' COMMAND. 

***** IMPORTANT NOTE: 

THIS SET OF DEBUG COMMANDS PRESUMES THE FOLLOWING 
CONFIGURATION OF THE AMPL HARDWARE: 

- THERE IS ONE EMULATOR MODULE AND ONE TRACE MODULE 

< NAMED EM01 AND TM01). 

- THE EMULATOR AND TRACE MODULE ARE 'STRAPPED' TOGETHER 

WITH THE DATA AND CONTROL CABLES. 

- THE USER HAS A 911 VDT CONSOLE FOR INTERACTIVE USE. 

COMPLETE USER DOCUMENTATION OF THE DEBUG COMMANDS IS AVAILABLE ON 
FILE: DEBUG/DOC <FS990> OR . S*SVSLIB. AMPL$LIB DEBUGDQC CDX/10 3. 0> 


************************************************+*********************** 


NL 


"DEBUG COMMANDS" 


ARRAY ZDBG < 9 > 


NL 

'DEFINING: HELP' 

PROC HELP < 0, 1) BEGIN 
NL 

'EMULATOR CONTROL COMMANDS:' 

LOC 1 : NX5; 'LOADUP C < ' 'FILENAME' 'C , BIASC , EUM 13)3' 

' - INITIALIZE AND LOAD TARGET' 

LOC 1 : NX5; 'RUN C (PCI , WP 3) 3 - RUN THE TARGET SYSTEM' 

LOC 1.NX5; 'HALT - HALT THE TARGET SYSTEM' 

NL; NL 

'TARGET SVSTEM STATUS : ' 

LOC 1 : NX5; 'STAT - TARGET SVSTEM STATUS' 

LOC 1:NX5;'DR - DISPLAY REGISTERS' 

LOC 1 : NX5; 'DT C (FIRST! , LAST 3) 3 - DISPLAY TRACE 

NL; NL 

'TRACE SPECIFICATION:' 
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LOC 1 : NX5; ' TRACE C < COUNT! , QUAL 3) 3' 

LOC 1:NX0; 'COUNT: 0. . 256 <0=INFINITV), QUAL: IRQ, DBIN, -DBIN' 


NL; NL 

'BREAKPOINT 
LOC 1 : NX5; ' 
LOC 1 : NX5; ' 
LOC 1 : NX5; ' 
LOC 1 : NX5; ' 
LOC 1 : NX5; ' 


SPECIFICATION: ' 

TILL C < COUNT) I 

MREAD, MWR I TE> OR INSTR 

VALUE (DATA! , MASK 3) 

AT CADDR) ' 

DELAV (COUNT) 


COUNT: 1. . >FFFF ' 

CHOOSE ONE OR NONE' 
DEFAULT MASK IS >FFFF ' 

COUNT: 1. . 256' 


END 


PROC TRACE NULL . . DUMMV TRACE PROCEDURE 

PROC STAT NULL . . DUMMV STRT PROCEDURE 

NL 

DEFINING: LORDUP C < "FILENAME "C , BIAS! , EUM 3 3) 3' 

PROC LORDUP <0, 1) BEGIN 

NL; 'TX OR DX ? <0=TX, 1=DX)' 

IF READ THEN BEGIN 
EINT < 'EM01' ) 

TINT < 'TM01' ) 

END 

ELSE BEGIN 

EINT < 'EMU' ) 

TINT< 'TRA' ) 

END 

ETM=OFF 

. . INITIALIZE EMULATOR USER MEMORV 
IF ARG 0 GE 3 

THEN EUM = ARG 3 

ELSE EUM = ON . . DEFAULT TO EMULATOR MEMORV ENABLED 
. . LOAD THE USERS PROGRAM 
IF ARG 0 GE 1 THEN BEGIN 

LOC X = >A0 . . DEFAULT LOAD BIAS 

IF ARG 0 GE 2 THEN LOC 1 = ARG 2 
LOAD (ARG X, LOC 1) 

WP = <?LOC 1 
PC = @(LOC 1 +2) 

END 

. . INITIALIZE TRACING 
TRACE 

STAT 

END 


NL 

'DEFINING. RUN C CPC C , WP 3 ) 3' 

PROC RUN BEGIN 
TRUN 

IF ARG 0 GE X THEN PC=ARG 1 

IF ARG 0 GE 2 THEN WP=ARG 2 

ERUN 

STAT 

END 
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NL 

'DEFINING: HALT' 

PROC HALT BEGIN 
EHLT : X 
THLT : X 
STRT 
END 


TITLE: STRT 

REVISION: 08/30/77 

ftBSTRftCT ■ 

STRT USES SYSTEM VARIABLES EST, TNE, ETBO> AND EUM TO PRINT 
THE STATUS OF THE EMULATOR AND THE DEBUG SETUP. 


USAGE: 

STRT HAS NO ARGUMENTS AND MAY BE CALLED AT ANY TIME. 


ELEC 'STRT' > 


PROC TQURL CASE ZDBG C 2 > —DATA OF 
0 : : ' MEMORY CYCLES' 

IRQ : : ' INSTRUCTION ACQUISITIONS' 

DBIN : : ' READ MEMORY CVCLES' 

-DBIN : : 'WRITE MEMORY CVCLES' 

END 


NL 

'DEFINING: STRT' 

PROC STRT C0, BEGIN 

LOC 1 = CEST AND 1 > EQ 0 

' . EMULATION CONTROL 

NL; 'EMULATION CONTROL :'; LOC 1 : NX5; 

IF LOC 1 THEN BEGIN 
'HALTED' 

IF EUM THEN ' < EMULATOR USER MEMORY ENABLED) ' 

1-ETBO : N2X5D; ' SAMPLES TRACED:' 

IF TTBO LE TTBN THEN BEGIN 
TTBO.D; TTBN : D; 

END; 

TNE : NX5U; 'EVENTS COUNTED. ' 

NL; DR 
END 

ELSE BEGIN 

'RUNNING' 

IF EST AND 3 THEN ' AT IDLE' 

END 

. . DEBUG CONFIGURATION 

NL;NL; 'DEBUG CONFIGURATION :'; LOC 1 : NX5; 

/ TRftQE y 

IF ZDBGC1> NE 8 TrfEN ZDBGC1>:D 
ELSE ' ALL'; 

TQUAL 
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IF ZDBGC9) AND EVT THEN BEGIN 

NL; ' TILL: ' ZDBGC3):DNX5 
CASE <ZDBG<4) - DATA) OF 
0 : : ' MEMORV CVCLE- 
IAQ :: -INSTRUCTION ACQUISITION- 
DBIN-IAQ : : •'MEMORV READ" 

-DBIN : : --MEMORV WRITE - 
END 

IF ZDBGC6) NE 0 THEN BEGIN 
- VALUE: '; ZDBGC5) 

IF 2DBG <6> NE -1 THEN BEGIN 
' MASK. ' 2DBGC6) : H 
END 

END 

IF ZDBGC7) NE 0FFFF THEN BEGIN 
' AT ADDRESS: '; ZDBGC7); 

END 

IF ZDBG<8) NE 0 THEN BEGIN 

NL, ' DEL AV : - ; 2DBG < S > : D; TQUAL; 

END 

END 


END 


NL 

-DEFINING: DT C CFIRSTC , LAST 3) 3- 


PROC DT<0, 4) BEGIN 
NL, 

- INDEX ADDR DATA < HEX, ASCI I ) 

NL; 

LOC 2 = TTBN-19; 

IF LOC 2 LT TTBO THEN LOC 2 = TTBO; 
LOC 3 = TTBN 


INTERPRETATION'; 

. . LOC 2 IS TRA LOWER INDEX 
. . LOC 3 IS TRA UPPER INDEX 


IF ARG 0 GE 1 . . SET TRA LOWER INDEX 

THEN IF ARG 1 GE TTBO AND ARG 1 LE TTBN 
THEN LOC 2 = ARG 1 

IF ARG 0 GE 2 . . SET TRA UPPER INDEX 

THEN IF ARG 2 GE LOC 2 AND ARG 2 LE TTBN 
THEN LOC 3 = ARG 2; 

LOC 1 = ETBO + LOC 2 - TTBO . . ADJUST EMU INDEX 


WHILE LOC 2 LE LOC 3 
DO BEGIN 

LOC 2 : NDX3; 

IF LOC 1 GE ETBO AND LOC 
THEN ETB<LOC 1):H 
ELSE - -; 

TTBCLOC 2) : X4HA; 

IF TTBHCLOC 2, IAQ) 

THEN TTBCLOC 2):X6I 
ELSE BEGIN 

IF TTBHCLOC 2, DBIN) 
THEN - 
ELSE - 
TTBCLOC 2) 

END; 

LOC 2 = LOC 2+1; 

LOC 1 = LOC 1+1; 


: H; 


.. PRINT INDEX IN TRACE BUFFER 
LE ETBN 

PRINT TRACED ADDRESS IN HEX 

PRINT TRACED VALUE IN HEX, ASCI I 

. . DISPLAV THE INSTRUCTION 
ITS A DATA ACCESS 

READ - ... IT'S A READ 

WRITE -| . . IT'S A WRITE 

. DISPLAV THE DATA 


STEP TTB 
STEP ETB 


INDEX 

INDEX 
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END 


END 


DELE < ' TRACE ' > 

NL 

'DEFINING : TRACE C (COUNT! , QUAL 3) 3' 


PROC TRACE <0) BEGIN 

. . INITIALIZE THE DEFAULT STATE 


ZDBG<1> 

ZDBGO) 

ZDBGO) 

ZDBG<4> 

ZDBGO) 

ZDBGO) 

ZDBGO) 

ZDBG<8> 

ZDBGO) 


0 

DATA 

1 

DATA 

0 

0 

0FFFF 

0 

OFF 


TRACE COUNT 
. TRACE QUALIFIER 
. EVENT COUNT 
. BUS CONTROL QUALIFIER 
. DATA BUS COMPARISON VALUE 
. DATA BUS COMPARISON MASK 
. ADDRESS BUS COMPARISON VALUE 
. TRACE DELAV COUNT 
. HALTING CONDITIONS 


INITIALIZE AMPL HARDWARE PROCEDURES 


ETRC < ADDR, 236, EXT) 

ECMPCIAQ, 0FFFF) 

EEVT < INT) 

EBRKCOFF, SELF) 

TTRC < DATA, 0, EXT) 

TCMP<DATA+IAQ-DBIN, 0, 0, OFF) 

TEVT < 1, 0, INT+NORM+EACH) 

TBRKCOFF, EMU) 

CHECK FOR TRACE PROCEDURE ARGUMENTS 
IF ARG 0 GE 2 THEN BEGIN 

ZDBG<2) = ZDBG<2)+ARG 
ZDBG<4> = DATR+ARG 2 
END 


TRACE ADDRESS IN THE EMULATOR 
NO EMULATOR ADDRESS COMPARISON 
BUT WILL USE COMPARISON IF SELECTED 
TRACE MODULE MAV HALT THE EMULATOR 

. . TM DATA COMPARISON, NO LATCHES 
TM EVENT COUNTER 

STOP EMULATOR IF BREAKPOINT DEFINED 


. . TRACE QUALIFIER 
CMPR QUALIFIER 


IF ARG 0 GE 1 THEN IF ARG 1 NE 0 THEN BEGIN 

ZDBGO.) = ARG 1 . . TRACE COUNT 

ZDBGO) = FULL . BREAK ON TRACE BUFFER FULL 

END 

. . INITIALIZE 'TTRC' 

TTRC < ZDBG < 2 ) + < EMT-1 ) *Q0, ZDBGO), EXT) 

TBRK<ZDBGO>) 


END 


NL 

'DEFINING. TILL C (COUNT) 1 ' - 

PROC TILL <0) BEGIN 

. . CHECK FOR OPTIONAL ARGUMENT 
IF ARG 0 GE 1 THEN BEGIN 

ZDBG<3) = ARG 1 . . EVENT COUNTER 

TEVT <ZDBG<3)) 

END 

. . HALT ON AN EVENT < DEFAULT TO SAME AS TRACING) 
TCMP(ZDBG<4> ) 

ZDBGO) = ZDBGO) + EVT 
TBRK< ZDBGO)) 

END 
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DEFINING: MREAO> MWRITE, INSTR ' 
PROC MREAD BEGIN 

ZDBG<4> = DATA+DBIN-IAQ 
TCMP<ZDBG<4>> 

END 


. . LOOK FOR MEMORV READ 


PROC MWRITE BEGIN 

ZDBG<4> = DBTfi-DBIN 
TCMP<ZDBG<4>> 

END 


. . LOOK FOR MEMORV WRITE 


PROC INSTR BEGIN 

ZDBG<4> = DATA+IAQ 
TCMP<ZDBG<4>> 

END 


LOOK FOR INSTRUCTION ACQUISITON 


NL 

DEFINING: VALUE <DATA£ > MASK ' 


PROC 


VALUE <1> BEGIN 

CHECK FOR OPTIONAL ARGUMENT 
IF ARG 0 GE 2 THEN ZDBG<6> 
ELSE ZDBG<6> 


= ARG 2 . . TM COMPARISON MASK 

a -1 . . DEFAULT MASK 


INITIALIZE TRACE MODULE COMPARATOR 
ZDBG(5> = ARG 1 . . TM COMPARISON DATA VALUE 

TCMP<ZDBG<4>, ZDBG<5>, ZDBG<6>> 


END 


NL 

DEFINING: AT <ADDR) ' 

PROC AT d) BEGIN 

. . INITIALIZE EMULATOR COMPARATOR 
ZDBG<?> = ARG 1 
ECMP<ADDR> ARG 1 OR <1-EMT>> 
TCMP < ZDBG < 4 > +EMU > 

END 


NL 

"DEFINING: DELAV < COUNT >' 


PROC DELAV BEGIN 

. . INITIALIZE EVENT DELAV 

ZDBG<8) = ARG 1 . EVENT DELAV 

TEVT<ZDBG<3>, ARG -O 


END 
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TITLE: SIMPLE DEBUG COMMANDS (DOCUMENTATION) 

REVISION: 09/27/77 

ABSTRACT • 

THIS SET OF AMPL FUNCTIONS AND PROCEDURES IMPLEMENTS 
A SMALL. SIMPLE, UNIFORM SET OF COMMANDS FOR THE USER TO DEBUG A 
PROTOTYPE SYSTEM. THE COMMANDS ARE GROUPED INTO THREE BASIC 
COMMAND CLASSES : 

1) EMULATION CONTROL: (LOADUP, RUN. HALT) 

LOAD MEMORY, RUN AND HALT THE EMULATOR 

2) TARGET SYSTEM STATUS: (STAT, DR, DT) 

CURRENT EMULATION STATUS. REGISTERS AND TRACE BUFFER 

3) TRACE/BREAKPOINT SPECIFICATION: (TRACE, TILL, VALUE, AT, DELAY) 

USER SELECTION OF WHAT TO TRACE AND WHEN 
TO HALT THE EMULATION 

THE USER MAY OBTAIN A LIST OF THESE COMMANDS AND THE SYNTAX FOR 
THEIR ARGUMENTS AT ANY TIME BY USE OF THE 'HELP ' COMMAND. 

***** IMPORTANT NOTE: 

THIS SET OF DEBUG COMMANDS PRESUMES THE FOLLOWING 
CONFIGURATION OF THE AMPL HARDWARE: 

- THERE IS ONE EMULATOR MODULE ANO ONE TRACE MODULE 

(NAMED EM01 AND TM01). 

- THE EMULATOR ANO TRACE MODULE ARE 'STRAPPED' TOGETHER 

WITH THE DATA AND CONTROL CABLES. 

- THE USER HAS A 911 VDT CONSOLE FOR INTERACTIVE USE. 

THIS IS THE USER DOCUMENTATION FOR THE ABOVE COMMANDS. THE COMMANDS 
ARE DEFINED ON: DEBUG/PRC (FS990) OR 

. S*SYSLIB. AMPLSLIB. DEBUG (DX 3. 0) 


********************** *************************************** 1 ***** ,, ** , * , * t, *' J *' 


HELP COMMAND: 

DISPLAY THE SYNTAX OF THE DEBUG COMMANDS. 


EXAMPLE DISPLAY: 

EMULATOR CONTROL COMMANDS: 

LOADUP C ( 'FILENAME'! , BIAS! , EUM 3 3)3 - INITIALIZE AND LOAD TARGET RV 
RUN C (PCI , WP I) 3 - RUN THE TARGET SYSTEM 
HALT - HALT THE TARGET SYSTEM 

TARGET SYSTEM STATUS: 

STAT - TARGET SYSTEM STATUS 

DR - DISPLAY REGISTERS 

DT C (FIRST! , LAST I) 3 - DISPLAY TRACE 


TRACE SPECIFICATION: 

TRACE C (COUNTC , QUAL 3) 3 

COUNT: 0. . 256 (0=INFINITY), QUAL: IAQ, DBIN, -DBIN 


BREAKPOINT SPECIFICATION : 
TILL t (COUNT) 3 
MREAD, MWRITE, OR INSTR 
VALUE (DATAC , MASK 3) 


COUNT: 1. . >FFFF 
CHOOSE ONE OR NONE 
DEFAULT MASK IS >FFFF 
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RT CADDR) 

DELAV < COUNT) COUNT: 1. . 256 


♦I****************************************************,,,************.*,,.**.***.,,. 


EMULATOR CONTROL: 


LOAD AND INITIALIZE EMULATOR MEMORV 

INITIALIZE THE EMULATOR AND LOGIC STATE TRACE MODULES. 

TRANSFER AN OBJECT FILE INTO MEMORV OF THE TARGET 

SVSTEM AND INITIALIZE THE WP AND PC REGISTERS. 

LORDUP t < 'FILENAME 'C, BIASC, EUMI3) ]' 

'FILENAME' - MUST BE AN OBJECT MODULE. THE STANDARD TI 

OPERATING SVSTEM INTERFACE IS EXPECTED IN THE OBJECT 
MODULE - THE FIRST TWO WORDS ARE THE WORKSPACE POINTER 
AND INITIAL PROGRAM COUNTER RESPECT I VELV. THE WORKSPACE 
POINTER CWP) AND PROGRAM COUNTER CPC) ARE INITIALIZED 
TO THESE VALUES. 

BIAS - IS AN ADDRESS BV WHICH TO RELOCATE THE OBJECT MODULE. 

THE DEFAULT BIAS IS >A0. 

EUM - SELECTS 'EMULATOR USER MEMORV ' , A 4K WORD < ADDRESSES 

0 THROUGH >1FFF) BLOCK OF MEMORV ON THE EMULATOR MODULE. 
'ON' WILL CAUSE THE TARGET SVSTEM TO USE THE EMULATOR 
MODULE MEMORV IN THIS ADDRESS RANGE. 'OFF' WILL ALLOW 
THE TARGET SVSTEM TO ADDRESS ITS OWN MEMORV IN THE ADDRESS 
RANGE >0080 THROUGH >1FFF. THE DEFAULT VALUE OF EUM IS 
'ON' (USE EMULATOR USER MEMORV). 


RUN EMULATION 

BEGIN EXECUTION IN THE TARGET SVSTEM WITH THE CURRENT 
WORKSPACE AND PROGRAM COUNTER IF NOT SPECIFIED IN THE 
COMMAND. 

RUN C CPC C, WPI) I 


HALT EMULATION 

STOP EMULATION IN THE TARGET SVSTEM. A 'STAT' COMMAND 
IS ALSO PERFORMED. 

HALT 




TARGET SVSTEM STATUS: 
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EMULATION STATUS 

display information concerning the current status of 

THE TARGET SYSTEM < EMULATION CONTROL >, AND THE 
TRACE/BREAKPO I NT SELECTION < DEBUG CONFIGURATIONS 

STAT 

EXAMPLE DISPLAY. 


EMULATION CONTROL: 



HALTED 


< EMULATOR 

USER 

! MEMORY 

ENABLED > 



256 

SAMPLES TRACED: 

-255 . . 

0 



2 

EVENTS COUNTED. 



R0 

S 

>FFFF 

R8 

= >1C45 

PC 

= >0132 

/ >0601 

R1 

= 

>0FE6 

R9 

= >1C44 

WP 

= >0138 


R2 

= 

>0000 

R10 

= >1444 

ST 

= >D200 


R3 

= 

>0000 

Rll 

= >010E 




R4 

= 

>1C45 

R12 

= >1FE0 




R5 

= 

>1C44 

R13 

= >1844 




R6 

s 

>1C45 

R14 

= >1845 




R? 

= 

>1444 

R15 

= >1800 





DEBUG CONFIGURATION. 

TRACE. ALL MEMORY CYCLES 
TILL: 2 

INSTRUCTION ACQUISITION AT ADDRESS: >0106 
DELAY: 123 MEMORY CYCLES 


DISPLAY THE WORKSPACE REGISTERS 


DISPLAY THE CURRENT VALUE OF THE PROGRAM COUNTER, 

THE WORKSPACE, AND THE VALUES OF THE WORKSPACE 
REGISTERS THIS INFORMATION IS ALSO INCLUDED IN THE STAT 
COMMAND. THIS COMMAND MAY ONLY BE USED WHEN THE 
EMULATOR IS NOT EXECUTING. 

DR 


EXAMPLE DISPLAY: 


RO 

= 

>FFFF 

R8 

= 

>1C45 

PC 

R1 

= 

>0FE6 

R9 

= 

>1C44 

WP 

R2 

= 

>0000 

R10 

= 

>1444 

ST 

R3 

= 

>0000 

Rll 

= 

>010E 


R4 

= 

>1C45 

R12 

= 

>1FE0 


R5 

= 

>1C44 

R13 

= 

>1844 


R6 

= 

>1C45 

R14 

= 

>1845 


R7 

= 

>1444 

R15 

= 

>1800 



= >9132 / >0601 DEC R1 

= >0138 
* >D200 


DISPLAY THE TRACE BUFFER 
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DISPLAY AND INTERPRET THE TRACE SINCE THE LAST RUN. 

EACH SAMPLE OF THE TRACE BUFFER CONSISTS OF THE ADDRESS BUS, 
DATA BUS, AND BUS CONTROL LINES. THIS INFORMATION IS 
DISPLAYED ALONG WITH THE INDEX INTO THE BUFFER ALONG THE 
LEFT HAND SIDE. THE NUMBER OF SAMPLES TRACE IS GIVEN 
BY THE ' STRT ' COMMAND. THIS COMMAND MAY ONLY BE USED WHEN 
THE EMULATOR IS NOT EXECUTING. 

DT C CFIRSTC, LAST!) 3 

NO ARGUMENTS WILL DISPLAY THE LAST 20 SAMPLES TAKEN. 

ONLY ONE ARGUMENT WILL DISPLAY 20 SAMPLES BEGINNING 
WITH THE THE ARGUMENT SPECIFIED. 

TWO ARGUMENTS DISPLAYS THE TRACE BETWEEN THE TWO INDICES. 

EXAMPLE DISPLAY: 


INDEX 

ADDR 

DATA < HEX, ASCII > 

INTERPRETATION 

-12 

>0132 

>0601 . . 

DEC 

R1 

-11 

>013A 

>0002 . . 


READ >0002 

-10 

>013A 

>0001 . . 


WRITE >0001 

-9 

>0134 

>16FE . ~ 

JNE 

*->0002 

-8 

>0132 

>0601 

DEC 

R1 

-7 

>013R 

>0001 


READ >0001 

-6 

>013A 

>0000 


WRITE >0060 

-5 

>0134 

>16FE . ~ 

JNE 

*->0002 

-4 

>0136 

>045B . C 

RT 


-3 

>014E 

>0120 . 


READ >0120 

-2 

>0120 

>10F2 . R 


READ >10F2 

-1 

>0120 

>10F2 . R 

JMP 

*— >001A 

0 

>0106 

>0200 . . 

LI 

R0, >0000 

1 

>0108 

>FFFF . . 


READ >FFFF 

2 

>0138 

>FFFF . . 


WRITE >FFFF 

3 

>010A 

>06A0 . 

BL 

@>0000 

4 

>010C 

>0122 . “ 


READ >0122 

5 

>0122 

>0200 . . 


READ >020C 

6 

>014E 

>010E . . 


WRITE >010E 

7 

>0122 

>020C . . 

LI 

R12, >0006 


**************************>M<*********W**********************************+* 


TRACE/BREAKPO I NT SELECT I ON . 

THIS SET OF DEBUG COMMANDS ALLOWS THE USER TO QUICKLY SPECIFY 

- WHAT TO TRACE. 

- A MAXIMUM NUMBER OF TRACE SAMPLES DESIRED. 

- THE NUMBER OF 'EVENTS' TO COUNT BEFORE GENERATING A BREAKPOINT' 

CONDITION. 

- WHAT CONSTITUTES AN 'EVENT'. 

- THE NUMBER OF SAMPLES TO TAKE AFTER 'BREAKPOINT' 

BEFORE ACTUALLV HALTING THE EMULATOR. 

WHERE AN 'EVENT' IS DEFINED AS THE SUCCESSFUL MATCHING OF A 
USER SPECIFIED DATA BUS VALUE AND/OR ADDRESS BUS VALUE AND/OR 
BUS CONTROL QUALIFIER. FOR EXAMPLE A TYPICAL 'EVENT IS AN 
INSTRUCTION ACQUISITION AT ADDRESS >100 OR A MEMORY WRITE 
OF DATA VALUE >1A AT ADDRESS >230. 

AFTER 'N' NUMBER OF SUCH EVENTS HAVE OCCURED A 'BREAKPOINT' 
CONDITION IS GENERATED. THE BREAKPOINT' SIGNAL REQUESTS THE 
EMULATOR TO HALT EXECUTION FOLLOWING COMPLETION OF THE CURRENTLY 
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EXECUTING INSTRUCTION. ALTERNATIVELY, THIS HALTING ACTION MAY 
BE 'DELAYED' UNTIL A USER SPECIFIED NUMBER OF ADDTIONAL TRACE 
SAMPLES HAVE BEEN TAKEN. FOR EXAMPLE, THE NEXT 100 INSTRUCTIONS 
FOLLOWING THE 'BREAKPOINT' CONDITION. 

THE COMMANDS DEFINED HERE REPLACE THE AMPL EMULATOR/TRACE MODULE 
USER INTERFACE WITH A SIMPLE, UNIFORM YET POWERFULL COMMAND SET. 


TRACE SPECIFICATION: 

SPECIFY WHAT IS TO BE TRACE AND HOW MANY BEFORE HALTING 
THE EMULATION. THIS COMMAND MAY ONLY BE USED WHEN THE 
EMULATION IS HALTED AND MUST BE STATED BEFORE USE OF 
ANY OF THE BREAKPOINT SPECIFICATION COMMANDS. 

TRACE C (COUNT C,QUAL3)3 

IF NO ARGUMENTS ARE SPECIFIED ALL MEMORY CYCLES ARE TRACED. 
THE COUNT ARGUMENT INDICATES THE NUMBER OF TRACE SAMPLES 
TO TAKE BEFORE EMULATION IS HALTED. THE VALUE MAY 
BE FROM 0 TO 256. THE VALUE 0 INDICATES INFINITY - DO 
NOT HALT EMULATION CTHE DEFAULT VALUE). 

THE QUAL ARGUMENT MUST BE: IAQ, DBIN, OR -DBIN TO SPECIFY 
TRACING ALL INSTRUCTION ACQUISITIONS, ALL READ CYCLES, OR 
ALL WRITE CYCLES RESPECTIVELY. LEAVING THIS ARGUMENT OUT 
DEFAULTS THE TRACE SAMPLES TO ALL MEMORY CYCLES 
< INSTRUCTION ACQUISITIONS, READ AND WRITE CYCLES). 


BREAKPO I NT SPEC I F I C ATON : 

AN EVENT IS DEFINED AS A SPECIFIC TYPE OF MEMORY CYCLE, 
WITH A PARTICULAR DATA VALUE, AT A DEFINITE ADDRESS. 

A BREAKPOINT OCCURS AFTER N NUMBER OF EVENTS HAVE OCCURED. 


TILL 


THE TILL COMMAND SPECIFIES THAT AN EVENT IS BEING DEFINED. 

IF NO OTHER EVENT SPECIFICATION IS DONE THE DEFAULT EVENT 
IS ANY MEMORY CYCLE. 

TILL C < COUNT) 3 

COUNT - THE NUMBER OF EVENTS BEFORE A BREAKPOINT IS GENERATED. 
THE DEFAULT VALUE IS ONE <1). 


EVENT MEMORY CYCLE 

THE USER MAY SELECT ONE OF THE FOLLOWING COMMANDS: 
0 

INSTR - INSTRUCTION ACQUISITION CYCLE 

MREAD * - MEMORY READ CYCLE 
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MWRITE 


- MEMORY WRITE CYCLE 


IF NONE OF THE ABOVE ARE SFECIFIED THE EVENT IE 
DEFINED TO EE ANY MEMORY CYCLE. 


EVENT DhT F t VALUE 

A DATA BU S VALUE MAY BE S.r'EcIFIED BY USE OF THE VALIJE COMMAND. 
VALUE <DATA C ■ MASK 3 > 

DATA — VALUE TU MATCH ON THE D'ATA BUS FOR AN EVENT 
MASK — INDICATES WHICH E. 1 7 s OF DATA ARE fU t>E COMRARlED 

AGAINsT THE DATA BUS THE DEFAULT IS TO GFFFF OCuHF'ARE 
ALL 16 BITS OF DATA > 


EVENT ADDRESS 


AN ADDRESS SPECIFICATION REQUIRES THE EVENT TO OCCUR 
AT THAT ADDRESS. 


AT ■; ADDRESS) 


ADDRESS - A MEMORY CYCLE AT THIr- ADDRE*-S. DEFINES Ail EVEN! 


BREAKPOINT DELAY 


HALTING EMULATION OF THE TARGET SYSTEM MAY BE DELAYED 
FOLLOWING THE LAST EVENT BY USE OF THE DELAY COMMAND. 

DELAY < COUNT > 

COUNT — NUMBER OF TRACE SAMPLES Tij TAKE FOLLOWING THE 
LAST EVENT (BREAKPOINT CONDITION) BEFORE HALTING 
EMULATION COUNT MAY BE IN THE RANGE G TO 200. 


* + : T : + t + + ■+ + + + ■+ ■+ + t + + + + + T tS t + t t- -+- f t -f- .t r .+. .+ .- + ■+-■+ r r - t t t r * T Tr + +■ + + r;:+ t f -r r 

TRACE/ 'BREAKPO I NT SPECIFICATION EXAMPLES 

THE COMMAND'S DESCRIBED ABOVE SHOULD BE INVOKED IN THE ORDER 
GIVEN THEIR' USE IS ILLUSTRATED BELOW NOTE THAT THE GFTiCNRL 
ARGUMENTS OF EACH COMMAND DEFAULT TO REASONABLE VALUES 

TRACE 

TRACE < 10.. I AG 
TRACE <0, IRQ) 

TILL 

TILL CIO) 


TRACE INFINITE NUMBER' OF ALL MclMgRt L'tT_Lp.s 
TRACE NEXT 10 J NsTRTJU i luf. I -■ * . J.GN-. 

TRACE INFINITE NUMBER' uF INsTRUCi I <JN HCG:UlbI i JONS 

BREAK FO I NT ON THE FIRST EVF'G 
EAEAK.r'U I NT iJN THE TENTH EVENT 
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INSTR 

MREAO 

MWRITE 


. . FIN EVENT MUST BE AN INSTRUCTION ACQUISITION 

. . AN EVENT MUST BE A MEMORY READ 

. . AN EVENT MUST BE A MEMORY’ WRITE 


VALUE O10FF> . . LOOK FOR >10FF ON THE DATA BUS 

VALUE (>1000, >FF00) . . LOOK FOR >10XX ON THE DATA BUS (X-DGN'T CARE). 

ATO100) . . LOOK FOR >100 ON THE ADDRESS BUS 

DELAY (10) . . TAKE TEN MORE TRACE SAMPLES BEFORE HALTING 

. . EMULATION FOLLOWING N EVENTS. 


THE COMMANDS ARE USED IN CONJUNCTION TO DEFINE 
THE DEBUG CONFIGURATION. 


TRACE 

TILL 

INSTR 


. . TRACE ALL MEMORY CYCLES 
. . TILL THE FIRST 
. . INSTRUCTION ACQUISITION 


TRACE < 0, I AQ> 
TILL (10) 
MREAD 
AT <WP> 

DELAY (128) 


. . TRACE ALL INSTRUCTION ACQUISITIONS 
. . TILL THE 10TH 
. . MEMORY READ 
. AT WP (REGISTER ZERO) 

. . THEN CONTINUE TRACING FOR 128 MORE INSTRUCTIONS 


THE COMMANDS MAY BE TYPED ON THE SAME LINE. 

TRACE TILL(2) MWRITE VALUE (0200) AT (01234) DELAY (10) 

MEANS: TRACE ALL MEMORY CYCLES 
TILL THE SECOND 

MEMORY WRITE CVCLE OF VALUE HEX 200 AT ADDRESS HEX 1234 
DELAY 10 MEMORY CYCLES THEN HALT EMULATION. 
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. . TITLE: EDUMP: DUMP ADDRESSES FROM EMULATOR TRACE BUFFER 

..REVISION: 03/28/77 

..REVISION: 09/09/77 9980 UPDATES 

flBSTRRCT ' 

EDUMP PRINTS THE CONTENTS OF A SPECIFIED RANGE OF THE EMULATOR'S 
. . TRACE BUFFER, INTERPRETED AS EVEN ADDRESSES TAKEN FROM THE EMULATOR'S 
. . MEMORV ADDRESS BUS. 

. . USAGE . 

THE EMULATOR MUST BE SET UP TO TRACE ADDRESSES IN ITS BUFFER, 

. . BEFORE IT IS RUN. AFTER IT HAS HALTED, FOR WHATEVER REASON, EDUMP 
. . MAV BE USED TO EXAMINE A SEQUENCE OF TRACED ADDRESSES. EDUMP PRINTS 
. . ONE ADDRESS PER LINE. AT THE LEFT MARGIN IT PRINTS THE INDEX INTO 
. . THE EMULATOR TRACE BUFFER. NEXT IT PRINTS THE SAMPLED ADDRESS IN 
. . HEXADECIMAL. LAST IT PRINTS THE CONTENTS OF THE ADDRESSED WORD OF 
. . TARGET MEMORV, IN HEXADECIMAL, AS TWO ASCII CHARACTERS, AND DISAS- 
. . SEMBLED AS AN INSTRUCTION WORD. NOTICE THAT THE DISASSEMBLV MAV 
. . REQUIRE THE VALUES OF REGISTERS, AND THAT THESE VALUES WILL NOT 
. BE LIKELV TO BE THE SAME AT THE TIME OF DISASSEMBLV AS AT THE TIME 
. . OF EXECUTION OF THE INSTRUCTION. IF THE 9980 EMULATOR IS BEING 
. . USED, THEN THE ADDRESSES TRACED MAV BE BOTH EVEN AND ODD FOR 
. . EACH BVTE FETCHED OR, IF THE TRACE MODULE QUALIFIER Q0 IS BEING 
. . USED TO QUALIFV SAMPLES, THEN JUST ODD, OR JUST 
. EVEN ADDRESSES MAV BE TRACED. PLEASE REFER TO THE APPROPRIATE 
. . SECTION OF THE MANUAL FOR A DISCUSSION OF TRACING WHEN USING THE 
. . 9980 EMULATOR. 

EDUMP HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. FIRST IS THE 
STARTING INDEX TO BE USED. THE OPTIONAL SECOND ARGUMENT SPECIFIES 
_ . THE ENDING INDEX TO BE USED. IF IT IS OMITTED, THE STARTING INDEX 
. . PLUS NINETEEN IS USED, GIVING TWENTV SAMPLES. 

'DEFINING EDUMP' NL 


PROC 

EDUMP <0, 2> BEGIN 

IF 

ARG 0 EQ 0 



THEN LOC 2 = 

ETBO 


ELSE LOC 2 = 

ARG 1; 

IF 

ARG 0 GE 2 



THEN LOC 1 = 

ARG 2 


ELSE LOC 1 = 

LOC 2 + 19; 

IF 

LOC 1 GT ETBN 



THEN LOC 1 = 

ETBN; 


'EMU INDEX ADDR CONTENTS < HEX, ASCII, INSTR> '; NL, 

WHILE LOC 2 LE LOC 1 
DO BEGIN 

LOC 2 : ND; 

ETBCLOC 2>:X4H '/ '; 

@ETB<LOC 2>:HAI; 

LOC 2 = LOC 2+1 

END; 

END 

. TITLE: TDUMP : DUMP DATA BUS SAMPLES FROM THE TRACE BUFFER 

REVISION: 03/28/77 

09/09/77 99S0 UPDATES 

ABSTRACT 

TDUMP PRINTS THE CONTENTS OF THE TRACE MODULE TRACE BUFFER 
. ON THE CONSOLE, ASSUMING THAT THE TRACE MODULE HAS BEEN SET TO 
TRACE THE EMULATOR DATA BUS. IN THIS MODE THE LOW-ORDER 16 BITS 
OF EACH SAMPLE ARE TAKEN FROM THE DATA BUS AND THREE OF THE HIGH- 
. ORDER 4 BITS ARE TAKEN FROM THE BUS CONTROL LINES AND THE EMULATOR 
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COMPARISON CIRCUITRY. IF THE TRACE SAMPLES ARE NOT ACTUALLY FROM 
THE EMULATOR'S DATA BUS, THE INTERPRETATION PROVIDED BY THIS 
PROCEDURE WILL BE MEANINGLESS. THE FOLLOWING TRACE MODULE 
SETUP SHOULD BE USED TO PROPERLY SET UP THE 9900 EMULATOR 
TO TRACE 16 BIT DATA VALUES COR THE 9980 EMULATOR TO TRACE 8 
BIT DATA VALUES X 

TTRCCDATA, 256, EXT) 

THE TRACING QUALIFIER "Q0" IS NECESSARY FOR TRACING 16 BIT DATA 
VALUES IN THE 9980 EMULATOR. THE FOLLOWING TRACING SETUP IS USED. 

TTRC < DHTA-Q0, 256, EXT) 

PLEASE REFER TO THE APPROPRIATE SECTION OF THE MANUAL FOR A 
DISCUSSION OF TRACING WHILE USING THE 9980 EMULATOR. THE ABOVE 
COMMANDS SET THE TRACE MODULE TO STORE UP TO 256 SAMPLES BEFORE "FULL" 
BECOMES TRUE. THE NUMBER MAY- BE ANYTHING BETWEEN 1 AND 256, AND THE 
TERMINATION MODE MAY BE ANYTHING. THE IMPORTANT POINTS ARE THAT 
"DATA" MODE IS SELECTED AND "EXT" CLOCK IS USED C EMULATOR'S MEMORY 
CYCLE CLOCK). OF COURSE, THE DATA CABLE MUST BE CONNECTED FOR THE 
DATA BUS TO BE AVAILABLE FOR THE TRACE MODULE. 


USAGE : 

AFTER THE TRACE MODULE HAS HALTED CBY ITSELF, UNDER CONTROL OF 
THE EMULATOR, OR BY THE USER WITH "THLT" ) THE TRACE BUFFER MAY BE 
DUMPED WITH TDUMP. THERE IS ONE REQUIRED ARGUMENT AND ONE OPTIONAL 
ARGUMENT. THE FIRST IS THE STARTING INDEX TO BE USED. THE SECOND 
IS THE ENDING INDEX TO BE USED. IF IT IS OMITTED, THE START- 
ING INDEX PLUS 19 IS USED, TO DUMP 20 SAMPLES. 

EACH SAMPLE IS PRINTED ON A SEPARATE LINE. IN THE LEFT MARGIN, 

THE INDEX IS PRINTED. NEXT, IF THE EMULATOR COMPARE CIRCUIT WAS 
TRUE WHEN THE SAMPLE WAS TAKEN, +ECMP IS PRINTED. NEXT THE LOW- 
ORDER 16 BITS OF THE SAMPLE ARE PRINTED IN ONE OF THREE FORMATS. 

IF THE INSTRUCTION ACQUISITION LINE WAS TRUE WHEN THE SAMPLE WAS 
TAKEN, THEN THE SAMPLE IS DISASSEMBLED AS AN INSTRUCTION. IF 
NOT, THEN IF THE DATA BUS IN LINE WAS TRUE THE WORD "READ" IS 
PRINTED, OTHERWISE THE WORD "WRITE", AND FINALLY THE SAMPLE IS 
PRINTED IN HEXADECIMAL AND AS TWO ASCII CHARACTERS. IF THE 
TRACE MODULE WAS SET TO TRACE 8 BIT VALUES ON THE 9980 EMULATOR 
DATA BUS, THEN THE INSTRUCTION INTERPRETATION OF A SAMPLE 
ABOVE WILL BE MEANINGLESS. 


D! 


EFINING TDUMP' 


NL 


PROC 

TDUMP <0, 2) 

BEGIN 

IF 

ARG 0 EQ 0 




THEN LOC 

2 = 

TTBO 


ELSE LOC 

2 = 

ARG 1 

IF 

ARG 0 GE 2 




THEN LOC 

1 = 

ARG 2 


ELSE LOC 

1 = 

LOC 2 +19 

IF 

LOC 1 GT TTBN 



THEN LOC 

1 = 

TTBN, 


TRA INDEX ECMP? DATACHEX, ASCI I ) INTERPRETATION'; NL, 
WHILE LOC 2 LE LOC 1 DO 'BEGIN 
LOC 2ND, 

IF TTBHCLOC 2, EMU) 

THEN ' +ECMP 
ELSE ' 
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TTBCLOC 2>:HA; 

IF TTBH<LOC 2, IRQ) 

THEN TTBCLOC 2>:X7I 
ELSE BEGIN 

IF TTBHCLOC 2, DBIN> 

THEN ' READ ' 

ELSE ' WRITE * ■, 

TTB<LOC 2> : H 

END; 

LOG 2 = LOC 2+1 

END 

END 

. . TITLE: TEDUMP: DUMP EMULATOR AND TRACE BUFFERS TOGETHER 

...REVISION: 02/28/7 7 

09/09/77 9980 UPDATES 

. . ABSTRACT : 

TEDUMP PRINTS THE CONTENTS OF THE EMULATOR AND TRACE MODULE 
. . TRACE BUFFERS TOGETHER. TEDUMP ASSUMES THAT THE EMULATOR HAS SAMPLED 
. ADDRESSES AND THE TRACE MODULE DATA, AND THAT THE QUALIFIERS FOR THE 
TWO TRACINGS WERE THE SAME. THIS IMPLIES THAT ON EVERV QUALIFIED 
. . MEMORY CYCLE BOTH THE EMULATOR AND THE TRACE MODULE SAMPLED SIMUL- 
. . TANEOUSLY. THUS THE SAMPLES IN THE TWO BUFFERS ARE SYNCHRONIZED, 

. AND MAY BE CONSIDERED TOGETHER MEANINGFULLY. THERE ARE VARIOUS 
. . WAYS TO ACHIEVE THIS, ONE OF WHICH IS TO TRACE ALL MEMORY CYCLES 
..IN BOTH BUFFERS. 

. . USAGE : 

TEDUMP MAY ONLY BE CALLED WHEN THE TRACE MODULE AND THE EMULATOR 
. . ARE BOTH HALTED. 

BEFORE TRACING, THE USER SHOULD ENSURE THAT THE DATA CABLE AND 
THE CONTROL CABLE ARE BOTH CONNECTED. HE SHOULD SET UP TRACING IN 
. EACH MODULE SO THAT BOTH SAMPLE SIMULTANEOUSLY. THE EASIEST WAY TO 
ACCOMPLISH THIS IS TO USE THE EXTERNAL CLOCK SELECTION IN BOTH ETRC 
AND TTRC. FURTHER, THE EMULATOR SHOULD TRACE ADDR AND THE TRACE 
MODULE SHOULD TRACE DATA+X, WHERE X IS ANY DESIRED QUALIFICATION. 

. THE TRACE MODULE SHOULD NOT HALT ITSELF, BUT MAY HALT THE EMULATOR 
. AND THEN HALT AS A RESULT OF THE EMULATOR HALTING. WHEN USING 
. . THE 9980 EMULATOR, THE QUALIFIER Q0 SHOULD BE USED FORCE FULL 
.16 BIT (RATHER THAT 8 BIT > DATA TRACES TO OCCUR IN THE TRACE MODULE. 
THE FOLLOWING SETUP WILL TRACE THE EXECUTION OF 10 INST- 
. RUCTIONS IN THE EMULATOR. THE EMULATOR AND TRACE COMMANDS NOT 
..MENTIONED <ECMP, EEVT, TCMP, TEVT> MAY BE SET HOWEVER THE USER WISHES. 

. . THE SETUP IS CORRECT FOR TRACING 16 BIT DATA VALUES WHEN USING 
. . THE 9900 EMULATOR OR 8 BIT DATA VALUES IN THE 9980 EMULATOR. THE 
. . QUALIFIER "-Q0" SHOULD BE USED ON THE "DATA" PARAMETER OF THE 
. . TTRC COMMAND IF THE USER WISHES TO TRACE 16 BIT DATA VALUES 
. . FETCHED BY THE 9980. PLEASE REFER TO THE APPROPRIATE SECTION OF 
. . THE MANUAL FOR A DISCUSSION OF TRACING WITH THE 9980 EMULATOR. 

ETRC < ADDR, 10, EXT > 

TTRC (DATA, 256, EXT > 

EBRK (FULL, SELF > 

TBRK(OFF, OFF; 

. . THE TRACE MODULE MAY BREAK ON EITHER FULL OR EVT, BUT MUST CONTINUE 
. . TRACING UNTIL THE EMULATOR HAS STOPPED TRACING. 

AFTER THE EMULATOR HAS HALTED, HALTING THE TRACE MODULE WITH 
IT VIA THE CONTROL CAEI^E, THE TWO BUFFERS CONTAIN THE SAME NUMBER 
. . OF SAMPLES, TAKEN AT THE SAME TIMES. TEDUMP MAY BE USED TO DUMP 
. . THEM IN PARALLEL, SHOWING BOTH THE ADDRESS AND DATA LINES OF THE 
. EMULATOR'S MEMORY BUS. 
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TEDUMP HAS TWO. ARGUMENTS : START AND END. THE RANGE OF INDICES 

. . START. . . END IS USED TO DISPLAV SAMPLES FROM THE EMULATOR BUFFER. 

. . IF END IS OMITTED, START PLUS 19 SAMPLES ARE DISPLAYED GIVING 
. . A 20 SAMPLE DEFAULT DISPLAV. 

. . CORRESPONDING SAMPLES ARE TAKEN FROM THE TRACE MODULE BUFFER BUT 
. . WITH POSSIBLY DIFFERENT INDICES, IF TCMP AND TEVT HAVE BEEN SET TO 
. . COUNT EVENTS AND DELAYS. THESE ARE DISPLAYED IN THE APPROPRIATE 
. . FORMAT ACCORDING TO THE CONTROL SIGNALS TRACED IN THE HIGH FOUR 
. . BITS OF EACH TRACE BUFFER WORD. REMEMBER THAT IF A 9980 
. . EMULATOR IS BEING USED, THE QUALIFIER G0 DETERMINES WHETHER 
. . CA> BYTE ADDRESSES AND DATA ARE BEING TRACED OR CB> ODD WORD 
. . ADDRESSES AND 16 BIT DATA VALUES ARE BEING TRACED. REFER 
. . TO THE APPROPRIATE SECTION OF THE MANUAL FOR DISCUSSION 
. . OF TRACING WITH THE 9980 EMULATOR. 

'DEFINING TEDUMP' NL 


PROC TEDUMP C0, 4 > BEGIN 

'EMU INDEX ECMP? ADDR TRA INDEX DATA C HEX, ASO INTERPRETATION'; 
NL; 


IF ARG 0 EQ 0 

THEN LOC 1 = ETBO; 

ELSE IF ARG 1 LT ETBO 
THEN LOC 1 = ETBO 
ELSE LOC 1 = ARG 1; 
IF ARG 0 GE 2 

THEN LOC 3 = ARG 2 
ELSE LOC 3 = LOC 1 + 19; 
LOC 4 = TTBN - CTTEO-ETBO> 

IF ETBN GT LOC 4 

THEN LOC 4 = ETBN; 

IF LOC 3 GT LOC 4 


. . . END WAS SUPPLIED 
. . . END WAS NOT SU PLIED 


THEN LOC 3 = LOC 4; 

LOC 2 = TTBO + LOC 1 - ETBO; ... INITIAL TRACE BUFFER INDEX 

WHILE LOC 1 LE LOC 3 
DO BEGIN 

IF LOC 2 GE TTBO AND LOC 2 LE TTBN 
THEN LOC 4 = -1 ELSE LOC 4=0; 

IF LOC 1 GE ETBO AND LOC 1 LE ETBN 
THEN BEGIN 

LOC 1 : ND; ...PRINT INDEX IN ETB 

IF LOC 4 EQ 0 THEN ' — N/A — ' 

ELSE IF TTBHCLOC 2, EMU> 

THEN ' +ECMP ' ... EMULATOR COMPARE TRUE 

ELSE ' '; 

ETB < LOC 1> :H; ... ADDRESS 

END; 


IF LOC 4 NE 0 THEN 
BEGIN 
LOC 2:D4; 

TTBCLOC 2 > : X4HA; 

IF TTBHCLOC 2, IAQ) 

THEN TTBCLOC 2>:X4I 
ELSE BEGIN 


... PRINT THE INDEX IN TTB 

... PRINT VALUE IN HEX 

. . . DISPLAV THE INSTRUCTION 
. . ITS A DATA ACCESS 


END; 


IF TTBHCLOC 
THEN ' 

ELSE ' 

TTBCLOC 2 > . H; 


2, DBIN> 

READ ' ... IT S A READ 

WRITE '; ... IT'S A WRITE 

. . . DISPLAV THE DATA 


END; 

LOC 2 = LOC 2+1, ... STEP TTB INDEX 

LOC 1 = LOC 1+1; ... STEP ETB INDEX 
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END 


END 
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TITLE: FNDBVT: SEARCH MEMORV FOR A SPECIFIED SUBBVTE 

REVISION: 06/07/77 

ABSTRACT: 

FNDBVT SEARCHES A SPECIFIED RANGE OF MEMORV IN THE TARGET 
SYSTEM TO FIND A BYTE CONTAINING A SPECIFIED VALUE. IN A SPECIFIED 
FIELD. 

USAGE : 

FNDBVT CAN BE CALLED WHENEVER THE EMULATOR IS HALTED. 

FNDBVT CAN HAVE ONE TO FOUR ARGUMENTS. THE POSSIBLE FORMS ARE 
GIVEN BELOW: 

FNDBVT < START - END- VALUE- MASK) 

FNDBVT (START- END- VALUE? 

FNDBVT (VALUE- MASK) 

FNDBVT (VALUE) 


THE ARGUMENTS- THEIR MEANINGS, 

AND THEIR DEFAULT VALUES 

LU 

i 

DESCRIBED BELOW. 




NAME 

MEANING 


DEFAULT 

START 

LOW END OF ADDRESS RANGE TO SEARCH 

0 

END 

HIGH END OF 

ADDRESS RANGE 

>FFFF 

VALUE 

INTERESTING 

FIELD TO SEARCH FOR 

- 

MASK 

ONE BITS IN 

INTERESTING POSTITIONS 

>00FF 


THE RANGE OF BYTES ADDRESSES START. . . END IS SEARCHED FOR THE 
. . FIRST OCCURRENCE OF VALUE IN A BYTE. EACH BYTE IS MASKED WITH MASK 
. AND THEN COMPARED TO VALUE- SO THE INTERESTING FIELD MUST BE IN THE 
. CORRECT POSITION IN VALUE. IF SUCH AN OCCURRENCE IS FOUND- FNDBVT 
. RETURNS THE ADDRESS OF THE BVTE. IF NONE IS FOUND- FNDBVT RETURNS 
. >FFFF. THIS UNFORTUNATE AMBIGUITY CANNOT BE RESOLVED SIMPLY- SO 
..IT IS LEFT TO THE USER OF FNDBVT TO DETERMINE WHETHER >FFFF IS IN 
. . FACT A VALID ANSWER OR JUST A FAILURE FLAG. 

'DEFINING FNDBVT ' 


FIJNC FNDBVT (1- 8) BEGIN 
IF ARG 0 GE 3 


THEN BEGIN 




LOC 

1 

= 

ARG 

1 - 

LOC 

2 

= 

ARG 

2; 

LOC 

3 

= 

ARG 

3- 

END ELSE 

BEGIN 


LOC 

1 

= 

0; 


LOC 

2 

= 

>FFFF; 

LOC 

3 

= 

ARG 

1; 


END; 


. . RANGE WAS SPECIFIED 
. . START 
. . END 
. . VALUE 

. . RANGE WAS NOT SPECIFIED 


IF ARG 0 MOD 2 

THEN LOC 4 = >FF 
ELSE LOC 4 = ARG ARG 0; 

LOC 5 = MPV < LOC 3- 256); 

LOC 6 = MPV (LOC 4,256); 

LOC 7 = LOC 1; 

REPEAT BEGIN 

LOC 8 = @LOC 1; 

IF (LOC 8 AND LOC 6) EQ LOC 5 
THEN RETURN LOC 1; 

IF (LOC 8 AND LOC <\> EQ LOC 3 
THEN RETURN LOC 1+1; 
LOC 1 = LOC 1+2; 


. . . MASK WAS NOT SPECIFIED 
. . . MASK WAS SPECIFIED 
. . . HIGH BVTE VERSION OF VALUE 
. . . HIGH BVTE VERSION OF MASK 
. . . SAVE COPY OF START 

. . . FETCH A WORD ~ 

. . . FOUND IT IN HIGH BVTE 

, . . FOUND IT IN LOW BVTE 
. . . STEP TO NEXT WORD 


END UNTIL LOC 1 HI LOC 2 OR LOC 1 LOE LOC 7- 


RETURN -1 


END 
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TITLE: 

REVISION: 


FNDWRD: SEARCH TARGET MEMORY FOR A SUBWORD 

03/21/77 


ABSTRACT : 
FNDWRD 
CONTAINING 
ADDRESS OF 


SEARCHES A SPECIFIED RANGE OF TARGET MEMORY FOR A WORD 
A SPECIFIED VALUE IN A SPECIFIED FIELD. IT RETURNS THE 
THE FIRST SUCH WORD FOUND IN THAT RANGE. 


FNDWRD MAY BE CALLED WHENEVER THE EMULATOR IS HALTED. IT MAY 
HAVE AS MANY AS FOUR ARGUMENTS, OR AS FEW AS ONE. EACH FORMAT 
IS LISTED BELOW. THE RANGE IS INCLUSIVE. 

FNDWRD (START, END, VALUE, MASK ) 

FNDWRD (START, END, VALUE) 

FNDWRD ( VALUE, MASK ) 

FNDWRD (VALUE) 

t u corn FfiPM. THE ARGUMENTS AND THEIR DEFAULT VALUES ARE AS FOLLOWS. 


NAME 

MEANING 


DEFAULT 

START 

END 

LOW END OF ADDRESS RANGE 
HIGH END OF ADDRESS RANGE 


0 

0FFFE 

VALUE 

THE INTERESTING VALUE, IN 
PROPER FIELD 

ITS 


MASK 

THE INTERESTING FIELD HAS 
BITS IN IT 

ONE 

0FFFF 


•'DEFINING FNDWRD ' 


FUNC FNDWRD (1, 5) BEGIN 
IF ARG 0 GE 3 

THEN BEGIN 


LOC 

3 = ARG 

3; 

LOC 

1 = ARG 

1; 

LOC 

2 = ARG 

2; 

ELSE 

BEGIN 


LOC 

3 = ARG 

i. 


LOC 1 
LOC 2 

END; 

IF ARG 0 MOD 2 
THEN LOC 4 
ELSE LOC 4 
LOC 5 = LOC 1; 
REPEAT BEGIN 

IF (0LOC 1 


0 ; 

0FFFE, 


-1 

ARG ARG 0; 


WAS RANGE GIVEN? 

RANGE WAS GIVEN. 

VALUE ARGUMENT IS THIRD 
LOW END OF RANGE 
HIGH END OF RANGE 
RANGE WAS NOT GIVEN 
VALUE ARGUMENT IS FIRST 
USE RANGE 0. . . 

0FFFE 

WAS MASK GIVEN? 

NO, USE WHOLE WORD 

YES, USE SPECIFIED MASK 

SAVE LOW END FOR CHECKING 


AND LOC 4) EQ (LOC 3 AND LOC 4) 
THEN RETURN LOC 1, 

LOC 1 = LOC 1+2; 

END UNTIL LOC 1 HI LOC 2 OR LOC 1 LOE LOC 5, 

END 


Figure H-7. Listing of FNDWRD Procedure File 


H-32 


Digital Systems Division 


946244-9701 


.. TITLE: HIST: GENERAL PURPOSE HISTOGRAM ROUTINE 

. . REV I S I ON : 04/06/77 

ABSTRACT • 

ONE PROCEDURE DEFINITION IS CONTAINED IN THIS FILE. 

. . IN ADDITION AN ARRAV (HISTAR} IS DEFINED AND THE USER 
. . MUST PROVIDE A FUNCTION (SAMPLE} AND ONE USER VARIABLE <S>. 

. . THE HIST ROUTINE COLLECTS SAMPLES TO EVENTUALLY PLOT A 
. . HISTOGRAM OF FREQUENCY' OF SAMPLES OVER A SPECIFIED RANGE. 

. USAGE : 

HIST IS CALLED WITH TWO ARGUMENTS WHICH DEFINE THE 
. . RANGE OF SAMPLES OVERWHICH TO BUILD THE HISTOGRAM. FOR 
..EXAMPLE 'HISTO1000, >2000}' WILL CONSTRUCT A HISTOGRAM 
. . OF SAMPLES BETWEEN THE RANGE OF >1000 TO >2000 (SAMPLES 
. . OUTSIDE OF THIS RANGE ARE IGNORED}. IF NO ARGUMENTS ARE 
. . SPECIFIED THE RANGE DEFAULTS TO >0000 TO >FFFF. SAMPLES ' 

. . ARE OBTAINED THROUGH A FUNCTION WHICH MUST ALREADY BE 

DEFINED AT THE TIME HIST IS COPIED IN. IN ADDITION THE USER 
. . SYMBOL 'S' MUST BE DEFINED. AS LONG AS 'S' IS NON ZERO 
..SAMPLES WILL BE TAKEN BY THE 'HIST' ROUTINE. FOR EXAMPLE 
PROC SAMPLE BEGIN 

... STUFF TO OBTAIN THE SAMPLE VALUE 
IF <CONDITION> THEN S-0 . . . SIGNAL TO STOP TAKING SAMPLES 

RETURN <SAMPLE VALUE> 

END 

DEFINING HI STAR - HISTOGRAM ARRAY' 

DELE ('HI STAR'} ..DELETE ANY EXISTING HI STAR ARRAV 

ARRAY HI STAR (64} . . DEFINE HISTOGRAM ARRAY 

'DEFINING HI ST (RANGE} - HISTOGRAM ROUTINE' 

PROC HIST (0, 7> BEGIN 

HISTOGRAM OF SAMPLES OVER A GIVEN RANGE 

NOTE : : TWO ADDITIONAL ITEMS ARE NECESSARV TO USE 

THIS PROCEDURE: 1} A VARIABLE 'S' - AS LONG AS 
THIS VARIABLE IS NON ZERO SAMPLES ARE TAKEN. 

2} A FUNCTION 'SAMPLE' WHICH RETURNS A SAMPLE VALUE. 

. . . ARGUMENT 1 IS THE LOWER LIMIT OF THE VALUE. (0} 

. . . ARGUMENT 2 IS THE UPPER LIMIT OF THE VALUE. OFFFF} 

. . . LOC 1 IS THE LOW END OF THE RANGE. 

. . . LOC 2 IS THE HIGH END OF THE RANGE. 

. . . LOC 3 IS THE BUCKET WIDTH 

. . . DETERMINE THE DEFAULT VALUES IF NECESSARV 

IF ARG 0 GE 1 THEN LOC 1 = ARG 1 ELSE LOC 1 - O; 

IF ARG 0 GE 2 THEN LOC 2 - ARG 2 ELSE LOC 2 =- OFFFF; 

. . . ZERO THE HISTOGRAM ARRAY (LOC 10. . . LOC 75} 

FOR LOC 4 = 1 TO 64 DO HISTAR(LOC 4} = 0 

. . . DETERMINE THE BUCKED WIDTH 


MDR = O 

LOC 3 = DIV(64; LOC 2 - LOQ 1 + 63} ... BUCKET WIDTH 

'THE BUCKET WIDTH IS '; LOC 3 : HN; 
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. . COLLECT SAMPLES 

WHILE S DO BEGIN 

LOC 5 = SAMPLE; 

IF CLOC 5 HIE LOC 1) AND CLOC 5 
LOC 6 = LOC 5 - LOC 1 
MDR = 0 

LOC 3 = 1+DIVCLOC 2, LOC 6) 

HISTARCLOC 5 >=H I STAR CLOC 5) 

END; 

END; 

. . . PRINT OUT THE VALUES IN THE HISTOGRAM ARRAY 

FOR LOC 4 = 1 TO 64 DO BEGIN 

IF LOC 4 MOD 8 EQ 0 THEN NL; 

HISTARCLOC 4>:D; 

END; NL; 

. . . FIND THE MAXIMUM VALUE IN HISTOGRAM ARRAY 

LOC 4 = HISTARCl) . . ASSUMED MAXIMUM 

FOR LOC 5 = 1 TO 64 DO ... ARRAY INDEX 

IF HISTARCLOC 5> GT LOC 4 THEN LOC 4 = HISTARCLOC 5 >; 

'THE MAXIMUM IS '; LOC 4:D; NL; 

IF LOC 4 EQ 0 THEN BEGIN 'QUITTING'; RETURN; END; 

. . . FIND THE SCALING FACTOR 

LOC 4 = LOC 4 +7 
MDR=0 

LOC 4 = DIVC8, LOC 4); 

THE SCALE IS '; LOC 4:D;. . . . ' TYPE A NUMBER TO CONTINUE'; 

LOC 5=8; . . INITIALIZE LINE COUNT 

WHILE LOC 5 GE 1 DO BEGIN . . . LOOP TO SCAN A PAGE 

NL; 

LOC 6=L0C 5*L0C 4 

FOR LOC 7 = 1 TO 64 DO . . SCAN A LINE 

IF HISTARCLOC 7) GE LOC 6 THEN ELSE ' '; 

LOC 5=L0C 5-1; 

END; 

... PRINT HISTOGRAM 'HEADER' 


. GATHER A SAMPLE 
LO LOC 2> THEN BEGIN 


. . COMPUTE BUCKET INDEX 
+ 1; . . INCREMENT COUNT 


NL; 


NL; 

MDR=0 

LOC 4=DIVC4, LOC 2 - LOC 1 + 1>; 

LOC 1 : HX7; LOC 1+LOC 4 . HX3; . . . LABEL AXIS 

LOC 1+C2*L0C 4> : HX3; LOC 2-LOC 4 : HX9; 

LOC 2 : HN; 

' HISTOGRAM OF SAMPLES OVER A RANGE', 


END 


PRINT TITLE 
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. . TITLE: BL: SIMULATE fi BRANCH AND LINK INSTRUCTION 

..REVISION: 05/02/77 

RBSTRRCT ■ 

BL SIMULATES THE EXECUTION OF A BL INSTRUCTION IN THE 
. . TARGET SYSTEM. BL MAY BE CALLED WHENEVER THE EMULATOR IS HALTED. 

. USAGE : 

BL HAS ONE ARGUMENT, THE ADDRESS TO TRANSFER IN THE TARGET 
. . SYSTEM. THE CURRENT PC IS STORED INTO REGISTER ELEVEN <R11> 

. . AND THE PC CHANGED TO THE ADDRESS TO TRANSFER TO. THE CURRENT 
. WORKSPACE POINTER IS NOT CHANGED. NOTE THAT THE PC IS NOT 
. . INCREMENTED BEFORE IT IS STORED. 

'DEFINING BL' NL 

PROC BLCl) BEGIN 
Rll = PC; 

PC = ARG 1 
END 

. . . TITLE: 

. . . REVISION: 

. . . ABSTRACT : 

BLWP SIMULATES THE EXECUTION OF A BLWP INSTRUCTION IN THE 
TARGET SYSTEM. BLWP MAY BE CALLED WHENEVER THE EMULATOR IS HALTED. 


. . . THE OLD PC 
. . . NEW PC 

BLWP: SIMULATE A BLWP INSTRUCTION 

03/21/77 


. . USAGE : 

BLWP HAS ONE ARGUMENT, THE ADDRESS OF A TRANSFER VECTOR IN 
TARGET MEMORY. THE FIRST WORD OF THE TRANSFER VECTOR IS LOADED INTO 
. THE WORKSPACE POINTER AND THE SECOND WORD INTO THE PROGRAM COUNTER. 

. . THE PREVIOUS WP, PC, AND ST ARE STORED IN R13, R14, AND R15, RESPEC- 
. . TIVELY, OF THE NEW WORKSPACE. NOTE THAT THE PC IS HOT INCREMENTED 
. . BEFORE IT IS STORED. 

'DEFINING BLWP' NL 


PROC BLWP < 1, 1) BEGIN 


LOC 1 = WP, • ■ THE 

WP = 9ARG 1, • THE 

R13 = LOC 1; • • ■ THE 

R14 = PC; • THE 

R15 = ST; ■ THE 

PC = @< ARG 1 + 2>; THE 

END 


TITLE: INTR : SIMULATE AN INTERRUPT IN 

REVISION: 03/21/77 


CURRENT WP 
NEW WP 
OLD WP 
OLD PC 
OLD ST 
HEW 'PC 

TARGET SYSTEM 


. . i iuj i r,no i . 

INTR SIMULATES THE OCCURRENCE OF AN INTERRUPT ON A PARTICULAR 
INTERRUPT PRIORITY LEVEL. INTR FUNCTIONS THE SAME WAY THAT THE 
INTERRUPT ARBITRATION HARDWARE DOES. THAT IS, THE INTERRUPT IS ONLY 
HONORED IF THE CPU'S PRIORITY IS HIGHER THAN THE LEVEL ON WHICH THE 
INTERRUPT IS RAISED. IF THE PRIORITY ALLOWS THE INTERRUPT < DETER- 
MINED BY CHECKING ST> TO OCCUR, THEN A BLWF TRANSFER IS PERFORMED 
. . THROUGH THE VECTOR STORED AT THE APPROPRIATE INTERRUPT LEVEL. 

ALSO, THE PRIORITY OF THE CPU IS SET TO THE LEVEL OF THE INTERRUPT 
. . MINUS ONE. 

INTR HAS ONE ARGUMENT, THE LEVEL OF THE INTERRUPT REQUEST. 

INTR MAY BE CALLED WHENEVER THE EMULATOR IS HALTED. INTR RETURNS 
• . 0 IF THE INTERRUPT WAS NOT ALLOWED, AND -1 IF IT WAS. 
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•'DEFINING FUNCTION INTR' NL 


FUNC INTRCl, 12) BEGIN 

IF <ST BHD 15) GE HRG 1 
THEN BEGIN 

LOC 1 = WP; 

WP = 0CARG 1 * 4 ); 

R13 = LOC 1; 

R14 = PC; 

R15 = ST; 

PC = 0CARG 1*4 + 2 >; 

LOC 1 = ARG 1-1; 

IF LOC 1 LT 0 

THEN LOC 1=0; 

ST = CST AND 0FFF0) + LOC 1; 
RETURN -1; 

END ELSE 

RETURN 0; 


. . . INTERRUPT IS ALLOWED 
. . SAVE OLD WORKSPACE POINTER 
. . NEW WP 
. . OLD WP 
. . OLD PC 
. . OLD ST 
. . NEW PC 
. . NEW PRIORITY 

. . PATCH FOR LEVEL ZERO 
. . NEW ST 

. . INTERRUPT SUCCEEDED 
. . . INTERRUPT FAILED 


END 

. . . TITLE: 

. . . REVISION: 


RT: SIMULATE AN RT INSTRUCTION IN TARGET SYSTEM 

05/02/77 


noj i i . 

RT SIMULATES THE EXECUTION OF AN RT INSTRUCTION IN THE TARGET 
SYSTEM. THE CURRENT PROGRAM COUNTER CPC) IS CHANGED TO THE CONTENTS 
OF REGISTER ELEVEN CTHE RETURN ADDRESS). 


USAGE: 

RT HAS NO ARGUMENTS. 
IS HALTED. 


RT MAY BE CALLED WHENEVER THE EMULATOR 


'DEFINING RT' NL 


PROC RTC0) BEGIN 
PC = Rll; 

END 

...TITLE: RTWP : SIMULATE A RTWP INSTRUCTION 

...REVISION: 03/21/77 


IN TARGET SYSTEM 


RBSTRRCT ■ 

RTWP SIMULATES THE EXECUTION OF AN RTWP INSTRUCTION IN THE TARGET 
SYSTEM. 'WP, PC, AND ST ARE LOADED FROM R13, R14, AND R15, RESPEC- 
TIVELY. 


RTWP HAS NO ARGUMENTS. RTWP MAY BE CALLED WHENEVER THE EMULATOR 
. . . IS HALTED. 

DEFINING RTWP' NL 

PROC RTWPC0) BEGIN 
ST = R15; 

PC = R14; 

WP = R13; 

END 

. . . TITLE: 

. . . REVISION: 

RBSTRRCT ■ 

XOP SIMULATES AN EXTENDED OPERATION INSTRUCTION IN 
. TARGET SYSTEM. TWO ARGUMENTS ARE EXPECTED: 

1) THE 'VALUE' TO PASS TO THE XOP HANDLER ROUTINE. 


XOP: SIMULATE AN XOP IN TARGET SYSTEM 

05/02/77 
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2> THE XOP LEVEL NUMBER. 

R BLWP OPERATION IS PERFORMED TO TRANSFER THROUGH THE 
APPROPRIATE XOP LEVEL. REGISTER ELEVEN <R11> WILL CONTRIN 
THE 'VALUE' AS SPECIFIED BV THE USER. 


'DEFINING XOP' NL 

PROC XOP < 2 , 1> BEGIN 
LOC 1 = WP; 

WP = 0<ARG 2*4+ >40 >; 

R13 = LOC 1; 

R14 = PC; 

R15 = ST; 

PC * 0<ARG 2*4+ >42 >; 

Rll = ARG 1 

ST = ST OR <0000001000000000 

END 


. . . SAVE OLD WORKSPACE POINTER 
. . . NEW WP 
. . . OLD WP 
. . . OLD PC 
. . . OLD ST 
. . . NEW PC 

. . . VALUE TO PASS IN REGISTER 11 
. . . 'XOP' STATUS BIT 


Figure H-9. Listing of INSTR Procedure File (Sheet 3 of 3) 
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TITLE: SOFTWARE BREAKPOINTS 

REVISION: 07/13/77 

. ABSTRACT : 

THIS MODULE DEFINES USER PROCEDURES TO IMPLEMENT 
. A MULTIPLE BREAKPOINT SOFTWARE BREAKPOINT CAPABILITY. 

USAGE: 

THREE <3> PROCEDURES ARE AVAILABLE: 

SB - SET SOFTWARE BREAKPOINT 

CB - CLEAR SOFTWARE BREAKPOINT 

EB - EXECUTE FROM SOFTWARE BREAKPOINT 

’ EACH OF THESE ARE DESCRIBED INDIVIDUALLY BELOW. 

SOFTWARE BREAKPOINTS ARE IMPLEMENTED IN THE 
TARGET SYSTEM AS SPIN INSTRUCTIONS. THE SPINS ARE FLACED 
IN MEMORY USING THE 'SB' PROCEDURE. EXAMINATION OF TARGET 
. SYSTEM MEMORY AT SOFTWARE BREAKPOINT LOCATIONS 
WILL REVEAL SPIN INSTRUCTIONS < >10FF / JMP * >. 

. THE 'CB' PROCEDURE IS USED TO CLEAR A SOFTWARE BREAKPOINT. 

. THE EXECUTE FROM SOFTWARE BREAKPOINT < 'EB' > PROCEDURE STARTS THE 
. TARGET SYSTEM EXECUTING AND WILL HALT THE TARGET SYSTEM 
. AND RETURN TO THE USER WHEN A SOFTWARE BREAKPOINT IS HIT. 

. THE SOFTWARE BREAKPOINT PROCEDURES USE TWO ARRAYS DEFINED 
. IN THE USER SYMBOL TABLE. THESE ARRAYS SHOULD NOT BE 
. USED WHEN USING THE SOFTWARE BREAKPOINT PROCEDURES. 

SBA<8> 

SBI <8> 


NL 

DEFINING: SOFTWARE BREAKPOINT PROCEDURES' 


. . . DEFINE THE TWO ARRAYS TO BE USED : 

ARRAY SBA<8> . . . SOFTWARE BREAKPOINT 'ADDRESS' ARRAY 

ARRAY SB I < 8 > ...SOFTWARE BREAKPOINT 'INSTRUCTION' ARRAY 

' ' INITIALIZE THE ADDRESS ARRAY TO 'NO BREAKPOINTS SET' 

PROC INIT <0, 1) FOR LOC 1 = 1 TO 8 DO SBACLOC 1 > = >FFFF 
INIT . . INITIALIZE THE ADDRESS ARRAY 

DELE < ' INIT' > ..DELETE THIS TEMPORARY PROCEDURE 


NL 

'DEFINING: SB - SET BREAKPOINT' 

’ ’ ABSTRACT: SET A BREAKPOINT OR INSPECT ALL OF THE CURRENT 
BREAK PO I NTS 

INTERFACE :SYNTRX: SB t <<ADDRESS> C , < ADDRESS/ 1. . . > I 

IF THE ARGUMENT IS NOT SUPPLIED THEN SB 
LIST THE ADDRESS OF EACH SOFTWARE 
BREAKPOINT AND THE INSTRUCTION AT THAT ADDRESS. 
IF ARGUMENTS '<ADDRESS>> ARE INCLUDED, THEN 
A SOFTWARE BREAKPOINT IS SET AT EACH ADDRESS. 
...DIAGNOSTICS: 'BREAKPOINT SET AT HHHH' IS PRINTED FOR 

EACH BREAKPOINT SET. IF THIS MESSAGE IS NOT 
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PRINTED THEN THE BREAKPOINT TABLE IS FULL AND 
THE BREAKPOINT WAS NOT SET. 


PROC SB <0, 3> BEGIN . . . VARIABLE ARGUMENTS, THREE LOCAL VARIABLES; 

IF ARG 0 EQ 0 THEN BEGIN 
PRINT OUT ALL CURRENTLY SET BREAKPOINTS 
FOR LOC 1 = 1 TO 8 DO BEGIN 
LOC 2 = SBACLOC 1); 

IF LOC 2 NE >FFFF THEN BEGIN 

9L0C 2 = SBKLOC 1> . . RESTORE THE INSTRUCTION 

LOC 2 : NS; " / "; 0LOC 2:HI 

0LOC 2 = >10FF . . RESTORE THE SPIN 

END; 

END; 

END; 

ELSE FOR LOC 2 = 1 TO ARG 0 DO BEGIN 

SET SOFTWARE BREAKPOINT 
FOR LOC 1 = 1 TO 8 DO 

IF SBA<LOC 1> EQ >FFFF THEN BEGIN 

LOC 2 = ARG <LOC 2) . . ADDRESS TO BREAKPOINT 

SB A < LOC 1> - LOC 3 . . SAVE THE ADDRESS 

SBKLOC 1> * 0LOC 2 . . SAVE THE INSTRUCTION 

0LOC 3 => >10FF .. SET THE SPIN 

NL; "BREAKPOINT SET AT ", LOC 3:S 

ESCAPE 

END; 

END; 

END 


NL 

"DEFINING: CB - CLEAR SOFTWARE BREAKPOINT' 

ABSTRACT: CLEAR GIVEN OR ALL SOFTWARE BREAKPOINTS. 

INTERFACE: SVNTAX : CB C << ADDRESS} C , <ADORESS> 3. . . >3 

IF <ADDRESS> IS INCLUDED THEN CLEAR THE 
BREAKPOINT AT THAT ADDRESS. IF THER IS NO 
ARGUMENT THEN CLEAR ALL OF THE BREAKPOINTS. 

DIAGNOSTICS: "BREAKPOINT CLEARED AT HHHH ' MESSAGE WILL 

BE PRINTED FOR EACH BREAKPOINT CLEARED. IF THIS 
MESSAGE IS NOT PRINTED A SOFTWARE BREAKPOINT 
WHS NOT FOUND AT THE GIVEN ADDRESS. 


PROC CB <0, 2) BEGIN . . VARIABLE ARGUMENTS, TWO LOCAL VARIABLE; 
IF ARG 0 EQ 8 THEN BEGIN 
CLEAR ALL SOFTWARE BREAKPOINTS 

NL; "CLEARING ALL BREAKPOINTS" 

FOR LOC 1 = 1 TO 8 DO BEGIN 

IF SB A < LOC 1 > NE >FFFF THEN BEGIN 
0SBACLOC =“ SBKLOC 1) 

SBACLOC 1> = >FFFF 
END 

END, 

END; 

ELSE FOR LOC 2 = 1 TO ARG 0 DO BEGIN 
CLEAR SPECIFIED SOFTWARE BREAKPOINTS 
FOR LOC 1 = 1 TO 8 DO 
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IF SBfKLOC 1) EQ ARG <LOC 2> THEN BEGIN 
SSBACLOC 1) = SB I CLDC 1) 

SBACLOC 1) = >FFFF . . CLEAR THE BREAKPOINT 
NL; 'BREAKPOINT CLEARED AT '; 

ARGCLOC 2 ) : 5 

ESCAPE 

END; 

END; 

END; 


NL 

'DEFINING: EB - EXECUTE FROM SOFTWARE BREAKPOINT' 

’ ' ABSTRACT. EXECUTE FROM SOFTWARE BREAKPOINT 
. . . INTERFACE: SYNTAX: EB 

THE EB COMMAND STARTS TARGET SYSTEM EXECUTION FROM 
A SOFTWARE BREAKPOINT AND CONTINUES EXECUTION UP 
TO THE NEXT SOFTWARE BREAKPOINT ENCOUNTERED. THE 
INSTRUCTION AT THE ENCOUNTERED SOFTWARE BREAKPOINT 
IS NOT EXECUTED. SOFTWARE BREAKPOINTS ARE SET BY 
THE SB <SET SOFTWARE BREAKPOINT) COMMAND AND CLEARED 
BY THE CB < CLEAR SOFTWARE BREAKPOINT) COMMAND. 


NOTE : NOTE : . NOTE . . NOTE : : NOTE : . NOTE : : NOTE . : NOTE : : NOTE : : NOTE 
EBRUN IS A LOCAL PROCEDURE FOR THE 'EB' PROCEDURE. 

THIS ROUTINE DETERMINES HOW THE HOST SYSTEM STOPS THE 
TARGET SYSTEM ONCE A SOFTWARE BREAKPOINT IS HIT. TWO 
IMPLEMENTATIONS ARE DEFINED BELOW - CHOOSE THE ONE 
WHICH IS APPLICABLE TO THE AMPS HARDWARE VQU HAVE OR 
DEFINE YOUR OWN ROUTINE. VERSION #1 IS INITIALLY 
COMMENTED OUT, ASSUMING THAT THE HAS A TRACE MODULE. 

NOTE: NOTE. : NOTE : NOTE: : NOTE : : NOTE : : NOTE : : NOTE : : NOTE : : NOTE 


. EBRUN - VERSION #1 

- USES ONLY THE EMULATOR MODULE 

- PERIODICALLY STOPS THE TARGET SYSTEM TO SEE IF 
IT IS ON A SOFTWARE BREAKPOINT. TRACE CAPABILITY 
OF THE EMULATOR CANNOT BE USED <WILL TRACE SPINS) 

PROC EBRUN <0, 2) BEGIN . . RUN THE TARGET UNTIL SOFTWARE BREAKPOINT 
ETRC<OFF) . . TURN OFF THE TRACE CAPABILITY 

EBRKiOFF, OFF) . . MAKE SURE NOTHING ELSE STOPS US 
LOC 2 = 8 . . BREAKPOINT ENCOUNTERED FLAG 

. . PERIODICALLY STOP THE TARGET UNTIL ON A BREAKPOINT 
REPEAT BEGIN 

ERUN . . START THE TARGET SYSTEM 

WAIT <20) . . DELAY ONE SECOND 

EHLT . . STOP THE TARGET SYSTEM 

FOR LOC 1 = 1 TO 8 DO 

IF SBA<LOC 1) EQ PC THEN LOC 2=1.. SET FLAG TO TRUE 
END UNTIL LOC 2 
. . RETURN TO CALLER 
END 


EBRUN - VERSION #2 

- USES BOTH THE EMULATOR AND LOGIC STATE TRACE MODULES 

- THESE MODULES ARE INITIALIZED TO TRACE ALL ADDRESS 
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AND DATA PLACED ON THE RESPECTIVE BUSSES OF THE TARGET 
< PROCEDURE TEDUMP MAY BE USED TO EXAMINE THE RESULTS-' 

PROC EBRUN <0-0) BEGIN ..EXECUTE UNTIL SOFTWARE BREAKPOINT HIT 
. . PREPARE THE AMPS HARDWARE - 'USING TRACE ANAL VZER 
TTRC<DATA-KEMT-:1)*Q0- 256- EXT> . . TRACE ALL DATA IN TM 
TCMP<DRTA+IAQ- >10FF- >FFFF) ..DEFINE 'SPIN AS AN EVENT 
TEVTC1- 0- NORM+EACH+ I NT ) ..COUNT ONE EVENT- ZERO DELAYS 
TBRK<EVT- EMU) HALT EMULATOR ON SATISFACTION OF EVT. 'DELAV 

ETRC<ADDR- 256- EXT) . . TRACE ALL ADDRESS IN THE EMULATOR MODULE 
EBRKCOFF- SELF> HALT EMULATOR ON SIGNAL FROM TRACE ANALYZER 

. . START THE TARGET SYSTEM 

TRIJ N . . START THE TRACE ANALYZER MODULE 

ERUN . . START THE EMULATOR MODULE 

. . WAIT UNTIL EMULATOR HALTS 
WHILE EST AND 1 DO NULL 
. . RETURN TO CALLER 
END 


PROC EB <0-l) BEGIN ..EXECUTE FROM SOFTWARE BREAKPOINT 

• SEE IF THE PC IS CURRENTLY AT A SOFTWARE BREAKPOINT 
FOR LOC 1 = 1 TO S DO 

IF SBACLGC 1) EQ PC THEN BEGIN 

PC IS CURRENTLY AT A SOFTWARE BREAKPOINT 
0SBA<LOC 1) = SBICLOC 1) ..RESTORE THE INSTRUCTION 
'SINGLE STEP' THE TARGET SYSTEM PAST THIS BREAKPOINT 
ECMP< IRQ- PC) 

EEVTdNT) 

EBRKCEVT- SELF) 

ERUN 

<?SBA<LOC 1) = >10FF . . RESTORE THE SPIN INSTRUCTION 

ESCAPE 

END 

. EXECUTE THE TARGET SYSTEM UNTIL A SOFTWARE BREAKPOINT IS FOUND 
NL; 'STARTING THE EMULATOR'- NL 
EBRUN 

NL; 'BREAKPOINT ENCOUNTERED AT ADDRESS: ';PO:H 

. . RETURN TO CALLER 
END 


Figure H-10. Listing of SB Procedure File (Sheet 4 of 4) 


H-41 


Digital Systems Division 


946244-9701 



. . TITLE: SETMEM: SET R RANGE OF MEMORV TO CONSTANT VALUES 

..REVISION: 03/24/7? 

R6STRRCT * 

SETMEM WRITES A SPECIFIED VALUE INTO EVERV WORD OF A SPECIFIED 
. RANGE OF TARGET MEMORV. 

SETMEM HAS THREE ARGUMENTS. THE FIRST TWO SPECIFV THE RANGE OF 
. MEMORV TO BE FILLED WITH THE CONSTANT. THE OPTIONAL THIRD ARGUMENT 
IS THE VALUE TO BE WRITTEN INTO MEMORV. IF IT IS OMITTED, ZERO IS 
. USED FOR THE VALUE. SETMEM MAV BE CALLED ONLV WHEN THE EMULATOR IS 
. . HALTED. 

'DEFINING SETMEM' 


PROC SETMEM < 2,1) BEGIN 
IF ARG 0 EQ 3 

THEN LOC 1 = ARG 3 
ELSE LOC 1=0; 

REPEAT BEGIN 

0ARG 1 = LOC 1; 

ARG 1 = ARG 1+2; 

END UNTIL ARG 1 HI ARG 2 OR ARG 1 EQ 0; 
END 


. . . VALUE WAS SPECIFIED 
. . . NOT SPECIFIED 

. . . WRITE A WORD 
. . . INCREMENT ADDRESS 
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TITLE: SIE . SINGLE INSTRUCTION EXECUTION 

REVISION: 06/02/77 

ABSTRACT : 

SIE LETS THE EMULATOR EXECUTE ONE INSTRUCTION AND HALT. BEFORE 
IT EXECUTES THE INSTRUCTION, SIE PRINTS THE PC AND THE INSTRUCTION 
ABOUT TO BE EXECUTED. IF THE INSTRUCTION HAS A SOURCE < DEST I NAT I ON > 
OPERAND, SIE PRINTS ITS ADDRESS AND VALUE BEFORE AND AFTER THE 
INSTRUCTION IS EXECUTED. 

USAGE : 

WP, PC, AND ST MUST BE SET CORRECTLV FOR THE INSTRUCTION. 
NORMALLY, SIE MAV BE USED REPEATEDLY TO STEP THE EMULATOR THROUGH 
A PROGRAM ONE INSTRUCTION AT A TIME. 

SIE HAS ONE OPTIONAL ARGUMENT, WHICH SPECIFIES HOW MANY 
INSTRUCTIONS TO STEP THROUGH, ONE AT A TIME, BEFORE SIE RETURNS. 

SIE PRINTS THE INSTRUCTION ABOUT TO BE EXECUTED ON THE FIRST LINE. 

ON TWO MORE LINES SIE PRINTS THE VALUES OF WP, PC, AND ST, AND 
OF THE SOURCE AND THE DESTINATION OPERANDS, BEFORE AND AFTER THE 
INSTRUCTION IS EXECUTED, RESPECTIVELY. IF AN INSTRUCTION HAS 
NO SOURCE OR NO DESTINATION OPERAND, THE DISASSEMBLER SETS THE 
SYSTEM VARIABLE SRC OR DST, RESPECTIVELY, TO -1. IF SIE FINDS 
SRC <DST> EQUAL TO -1 IT ASSUMES THERE IS NO SOURCE < DEST I NAT ION > 
OPERAND AND DOES NOT PRINT THE ADDRESS <-l> OR VALUE BEFORE OR 
AFTER THE INSTRUCTION IS EXECUTED. ON THE FOURTH LINE SIE PRINTS 
THE NEXT INSTRUCTION TO BE EXECUTED, AT THE NEW PC. 

WHEN SIE IS USED, THE EMULATOR COMPARISON LOGIC MAV NOT BE 
USED. THE EMULATOR TRACE LOGIC AND THE TRACE MODULE MAV BE USED, 

BUT ONLY ONE INSTRUCTION WILL BE RECORDED. 


EFINING LOCAL PROC ZSIESD' 


PROC ZSIESD <0:> BEGIN . . . LOCAL PROCEDURE FOR SIE 


NL 

WP=' WP : H 

" PC=' 

PC : H ' ST= 

IF 

SRC NE 

-1 




THEN 

BEGIN 

' SRC=' 

SRC : H 

V ' @SRC:H 


END; 




IF 

DST NE 

-1 




THEN 

BEGIN 
' DST=' 

DST : H 

V '• 0DST.H 


END; 





END 

NL 

-•DEFINING SIE' 


PROC SIE <0, 1) BEGIN 
EEVT < INT>; 

EBRK < EVT, SELF); 

IF RRG 0 EQ 1 

THEN LOC 1 = ARG 1 
ELSE LOC 1=1; 
WHILE LOC 1 GT 0 
DO BEGIN 

@PC:NI, 

ZSIESD, 

ECMPC IRQ, PO, 
ERUN; 


USE INTERNAL EVENT LOGIC 
HALT WHEN NEXT PC EXECUTED 
HOW MANY TIMES TO REPEAT 


. . . CURRENT INSTRUCTION 
. . . LOCAL PROC PRINTS INFO 
. . . BREAK ON THE NEXT PC 
. . . SINGLE-STEP EMULATOR 


WHILE CEST AND 1> DO NULL 
ZSIESD; 

LOC' 1 = LOC 1-1 ... ITERATE THE PROCESS 
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END 


END; 

@PC : NXXXXXI; 

EBRKCOFF, OFF> 


. . . NEXT INSTRUCTION 
. . . TURN SIE STUFF OFF 
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...TITLE: ESTAT 

...REVISION: 05/02/77 

. . . ABSTRACT . 

ESTAT USES SVSTEM VARIABLES EST, ENI, ETBO, AND ETBN TO PRINT 
. . . THE STATUS OF THE EMULATOR MODULE. 

. . . USAGE : 

. . ESTAT HAS NO ARGUMENTS AND MAV BE CALLED AT ANV TIME. 

'■DEFINING ESTAT' NL 

PROC ESTAT <0> BEGIN 
EMULATOR IS ' 

IF <EST AND 1) EQ 0 
THEN 'NOT ' 

'EXECUTING' 

IF EST AND 8 

THEN ' AN IDLE INSTRUCTION' 


NL 'EMULATOR TRACE BUFFER IS ' 

IF <EST AND 2> EG 0 
THEN 'NOT ' 

'FULL. ' 

NL 'EVENT CONDITIONS ARE ' 

IF (EST AND 4> EQ 0 
THEN 'NOT ' 

'SATISFIED. ' 

ENI. NU 'BREAKPOINTS COUNTED. ' 

IF (EST AND 1> EQ 0 
THEN BEGIN 

ETBN-ETBO+1 : ND 'ADDRESSES TRACED' 

IF ETBN GE ETBO 
THEN BEGIN 

' : ' ETBO : D ' . . . ' ETBN : D, 

END 

END 

END 

...TITLE: TSTAT : PRINT TRACE MODULE STATUS 

REVISION: 05/02/77 

. . ABSTRACT : 

TSTAT USES SVSTEM VARIABLES TST, TNE, TNI, TTBO, AND TTBN TO 
... PRINT AN ENGLISH DESCRIPTION OF THE STATUS OF THE TRACE MODULE. 


USAGE . 

TSTAT HAS NO ARGUMENTS. 


DEFINING TSTAT' NL 


IT MAV BE CALLED AT ANV TIME. 


PROC TSTAT <0) BEGIN 
'TRACE MODULE IS ' 

IF <TST AND 1> EQ 0 
THEN 'NOT ', 

'TRACING. ' 

NL 'TRACE BUFFER IS ' 

IF CTST AND 2> EQ 0 

THEN 'NOT . 

FULL. ' 

NL EVENT CONDITIONS ARE ' 
IF < TST AND 4> EQ 0 
THEN 'NOT '; 
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'SATISFIED. ' 

TNI :NU 'BREAKPOINTS COUNTED. ' 

IF <TST AND 1) EQ 0 

THEN BEGIN 

TTBN— TTBO+1 : ND 'SAMPLES IN BUFFS?'; 
IF TTBN GE TTBO 
THEN BEGIN 

':' TTBO : D '. . . ' TTBN : D; 

END; 

TNE NU 'EVENTS COUNTED. ' 

END 

END 


Figure H-13. Listing of ST AT Procedure File (Sheet 2 of 2) 


H-46 


Digital Systems Division 


946244-9701 


TITLE. TDflTft: PRINT TRACE MODULE SAMPLES 

REVISION: 03/24/77 


ABSTRACT : 

TDATA PRINTS A SPECIFIED RANGE OF SAMPLES FROM THE TRACE MODULE 
TRACE BUFFER. THE SAMFLES ARE NOT INTERPRETED; ALL TWENTY BITS ARE 
PRINTED FOR EACH SAMPLE. 

USAGE : 

TDATA HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. THE FIRST 
ARGUMENT IS THE STARTING INDEX TO BE USED. THE OPTIONAL SECOND 
ARGUMENT IS THE ENDING INDEX. IF IT IS OMITTED, THE ENDING INDEX 
IS THE STARTING INDEX PLUS 29, GIVING 30 SAMPLES, IF THERE ARE 
THAT MANV IN THE TRACE BUFFER. TDATA MAV BE CALLED WHENEVER THE 
TRACE MODULE IS HALTED. 


DEFINING TDATA' NL 


PROC TDATA <1, 2 > BEGIN 
IF ARG 0 EQ 2 

THEN LOC 1 = ARG 2 
ELSE LOC 1 = ARG 1 + 29; 

IF LOC 1 GT TTBN 

THEN LOC 1 = TTBN; 

LOC 2 = 0; 

' INDEX HIGH LOW 

HIGH LOW'; 

WHILE ARG 1 LE LOC X 
DO BEGIN 

IF LOC 2 MOD 3 EQ 0 
THEN BEGIN 

ARG X : ND V ' 
END 
ELSE ' 

LOC 2 = LOC 2+1; 
TTBHCARG 1>:H; 

TTBCARG X) : HA; 

ARG 1 = ARG 1+1; 

END; 

END 

TITLE: TFOUR : 

REVISION: 05/06/77 


. . . ENDING INDEX WAS GIVEN 
. . . NOT GIVEN 


. . . LIMIT ENDING INDEX 
. . . SET NEWLINE FLAG 
HIGH LOW'; 


. . . START A NEW LINE 

. . . TAB TO NEXT COLUMN 
. . . STEP THE FLAG COUNTER 
. . . DISPLAV SAMPLE 


DISPLAV TRACED SAMPLES IN 4-BIT GROUPS 


ABSTRACT : 

TFOUR DISPLAYS A SPECIFIED RANGE OF TRACE BUFFER SAMPLES 
IN GROUPS OF FOUR BITS. 


USAGE : 

THE TRACE MODULE MUST BE HALTED AND CONTAIN SAMPLES. TFOUR 
HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. THE FIRST ARGUMENT IS 
REQUIRED AND SPECIFIES THE STARTING INDEX. THE SECOND ARGUMENT IS 
OPTIONAL AND SPECIFIES THE ENDING INDEX. IF IT IS OMITTED, START+ 
9 IS USED. 


'D 


EFINING TFOUR' 


NL 


PROC 


TFOUR < 1,2) BEGIN 
IF ARG 0 GE 2 

THEN LOC 1 
ELSE LOC 1 
'INDEX 0123 
FOR ARG 1 = ARG 


= ARG 2 
= ARG 1 + 9; 
4567 8901 

1 TO LOC 1 DO 


2345 

BEGIN 


6739 


0 


4826 ' NL, 
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ftRG 1:D5; LOC 2 = TTB<ARG 1>; 
TTBH<ARG 1) ;B4; 

MDR = 0; DIVO1000, LOC 2>:B4; 
<LOC 2 AND >0F00> / >106 :B4; 
<LOC 2 AND >00F0> / >10:B4; 

LOC 2 AND >000F : B4> 

TTBH<ARG 1) :H1; 

LOC 2.HN; 

END; 

END 
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TITLE; TIMER: TRACE MODULE TIMING OF EMULATOR 

REVISION: 03/24/77 


ABSTRACT : 

THIS ROUTINE SETS THE TRACE MODULE TO START TIMING WHEN 
THE EMULATOR IS NEXT STARTED. IT MAV BE CALLED AGAIN WHILE 
THE EMULATOR IS RUNNING OR AFTER THE EMULATOR HAS HALTED TO 
PRINT THE ELAPSED TIME SINCE THE EMULATOR WAS STARTED, 

COMPUTED FROM THE EVENT COUNTER, THE DELAV COUNTER, AND 
THE NUMBER OF INTERRUPTS GENERATED BV THE TRACE MODULE. 

THE TRACE MODULE MAV NOT BE USED FOR TRACING WHILE IT 
IS BEING USED FOR TIMING, BUT THE EMULATOR MAV TRACE. 

THE TIMING IS ACCURATE TO 100 NANOSECONDS WHEN THE EMULATOR 
HAS HALTED, AND TO S. 5 MILLISECONDS WHILE THE EMULATOR IS 
RUNNING. 

USAGE : 

THE CONTROL CABLE MUST CONNECT THE EMULATOR AND TRACE MODULE. 
NO OTHER TRACE MODULE COMMANDS SHOULD BE USED WHEN TIMER IS 
BEING USED. IF THE TRACE MODULE IS NOT RUNNING, TIMER WILL 
SET IT UP FOR TIMING AND START IT. 

THE PRESENCE OF THE OPTIONAL ARGUMENT SUPPRESSES THE 
PRINTING OF ELAPSED TIME. THIS ARGUMENT (ANY VALUE 
WILL DO> CAN BE USED WHEN TIMER IS BEING CALLED FOR THE 
FIRST TIME IN A SERIES OF TIMINGS, TO SET THE TRACE 
MODULE UP WITHOUT PRINTING MEANINGLESS TIMING INFORMATION. 

FOR EXAMPLE, 


? T I MER ( 0 } 

? ERUN 
? TIMER 

1 234 

? TIMER 

1 789 


(ARGUMENT SUPPRESSES PRINTING} 

( COMMANDS TO SET UP EMULATOR} 

(AFTER SETTING UP EMULATOR} 

(EMULATOR MAV STILL BE RUNNING} 

067 800 SECONDS, STILL TIMING 

(EMULATOR HALTS ITSELF, OR EHLT IS GIVEN} 
(NOW EMULATOR IS NOT RUNNING} 

12 300 SECONDS 


EFINING TIMER' 


OC TIMER(0, 


7} BEGIN 


VAR 

LOC 1 
LOC 2 
LOC 3 
LOC 4 
LOC 5 
LOC 6 
LOC 7 


FIRST SCRATCH, THEN NUMBER OF SECONDS ELAPSED. 
MILLESECONDS. 

MICROSECONDS. 

NANOSECONDS (ACCURATE TO 100 NS}. 

SCRATCH. 

SCRATCH. 

NUMBER OF EVENTS, IF TRACE IS HALTED; 

0 IF TRACE IS RUNNING. 


IF THE OPTIONAL ARGUMENT IS NOT PRESENT, CONFUTE ELAPSED 
TIME AND PRINT IT. 


IF ARG 0 EQ 0 

THEN BEGIN 


. . . IF THE TRACE MODULE IS ..HALTED, THEN USE NUMBER OF EVENTS. 

. . . OTHERWISE, USE ZERO AND GET APPROXIMATE ELAPSED TIME ONLY. 


IF -TST AND 1 
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THEN 

LOC 7 = 8 

ELSE 

LOC 7 = TNE; 

EACH THREE DIGITS OF THE ELAPSED TIME RIGHT OF THE DECIMAL 
. . POINT ARE COMPUTED SEPARATELY STARTING WITH NANOSECONOS. 

. . THE WHOLE FORMULA FOR THE ELAPSED TIME IS 

T = <63336 * TNI + TNE) * 1. 0E-8? 

. . BECAUSE TNE IS INCREMENTED EACH 100 NS, AND TNI IS INCREMENTED 
. . EACH 65, 336 TIMES TNE IS INCREMENTED. 

! THE NANOSECONDS POSITIONS ARE COMPUTED BV 
D9 * 600 * TNI + 100 * TNE 
. . AND PRINTED WITH 

D9 <MOD 1000> <ONLV THE LOW-ORDER THREE DIGITS). 

. . THE MICROSECONDS POSITIONS ARE COMPUTED BV 
D6 = 553 * TNI + <D9 DIV 1000> 

. WHERE ”DIV“ IS INTEGER DIVISION, SO <D9 DIV 1080) IS THE CRRRV 
FROM THE NANOSECONDS COMPUTATION INTO THE MICROSECONDS POSITION. 

. . AND PRINTED WITH 

D6 <MOD 1000). 

' THE MILLISECONDS POSITIONS ARE COMPUTED BV 
D3 * 6 * TNI + <D6 DIV 1000) 

. . AND PRINTED WITH 

D3 <MOD 1000). 

. . THE SECONDS POSITIONS, TO THE LEFT OF THE DECIMAL POINT, ARE JUST 
. . THE EXCESS IN D3 OVER 1000, VIZ. , 

D3 DIV 1000, 

AND MAV BE ABOUT AS LARGE AS 408 <6 OR 7 MINUTES) BEFORE OVERFLOW 
AND INFORMATION LOSS OCCURS. THUS THIS ROUTINE MAV BE USED TO 
TIME EMULATOR RUNS OF MOST INTERESTING LENGTHS. 

LOC 4 * MPV<180, LOC 7), 

LOC 5 * MDR; 

LOC 6 *= MPV < 600, TNI), 

LOC 5 = MDR * LOC 5 ; 

LOC 6 = LOC 4 + LOC 6, 

MDR = MDR + LOC 0, 

LOC 5 = DIVC1000, LOC 6); 

LOC 4 = MDR; 

LOC 3 = MPV<553, TNI); 

LOC 6 = MDR; 

LOC 3 » LOC 3 + LOC 5; 

MDR = MDR + LOC 6; 

LOC 6 = DIV <1000, LOC 2); 

LOC 3 - MDR; 

LOC 2 - MPV<6, TNI); 

LOC 1 * r-OR; 

LOC 2 * LOC 2 + LOC 6; 

MDR = LOC 1 + MDR; 

LOC 1 = DIV<1000, LOC 2). 

LOC 2 = MDR; 

0 

’.. PRINT THE RESULT, AT LAST. 

LOC 1 : D; • SECONDS 


. . . CARRV INTO MICROSECS 
. . . NANOSECS 


... CARRV INTO MILL I SECS 
. . . MICROSECS 


. . . CARRV INTO SECS 
. . . MILL I SECS 
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D 


DECIMAL POINT 
MILLISECONDS 
MICROSECONDS 
NANOSECONDS 


. . IF THE TRACE MODULE IS NOT HALTED, INDICATE SO. 

IF TST AND 1 

THEN BEGIN 

", STILL TIMING"; 

RETURN 

END; 

END 

. . . WHETHER THE OPTIONAL ARGUMENT IS THERE OR NOT, IF THE TRACE 
. MODULE IS HALTED, SET IT UP FOR THE NEXT TIMING RUN. 

IF <TST AND 1 > EQ 0 
THEN BEGIN 

TTRC<OFF, 256, INT>; 

TCMPCOFF, 0, 0>; 

TEVT<0, 0, INT+EACH+NORM); 

TBRKCEVT, OFF>; 

TRUN; 

END 

END 
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TITLE: TRACE: DISPLAY TRACE DATA IN TIME DOMAIN 

REVISION: 03/25/7? 

ABSTRACT : 

TRACE DISPLAYS THE DATA IN THE TRACE BUFFER IN A 
FORMAT SIMILIAR TO A LOGIC STATE ANALYZER 


USAGE: 

ARGUMENT 1 IS THE INDEX TO TTB TO PUT ON THE LEFT OF THE DISPLAY 

. . . THE DEFAULT VALUE IS TTBO 

ARGUMENT 2 IS THE FIRST BIT TO BE DISPLAYED 

. . . THE DEFAULT VALUE IS 0 

ARGUMENT 3 IS THE LAST BIT TO BE DISPLAYED 
. . . THE DEFAULT VALUE IS 19 
ARGUMENT 4 IS THE SCALE FACTOR 

. . . THE SCALE WILL DEFAULT TO 1 MARK/BIT NEGATIVE SCALES 
. . . ARE TAKEN AS BITS/MARK 


DEFINING TRACE PROCEDURE PLEASE WAIT'; 


PROC TRACE <0, 11> BEGIN . . . PRINT OUT TIMING DIAGRAM 
LOC 1 IS THE FIRST INDEX TO TTB 
LOC 2 IS THE FIRST BIT TO DISPLAY 
LOC 3 IS THE LAST BIT TO DISPLAY 
LOC 4 IS THE SCALE FACTOR IN MARKS/BIT 
LOC 5 IS THE INDEX TO TTB 
LOC 6 IS THE MASK FOR EACH BIT 
LOC 7 IS THE SCALE COUNTER 
LOC 8 IS THE MAXIMUM INDEX TO TTB 
LOC 9 IS THE VALUE TO MASK OFF FOR EACH BIT 
LOC 10 IS THE PREVIOUS VALUE OF LOC 9 
LOC 11 IS A FLAG FOR NEGATIVE SCALES 


. . SET UP DEFAULT VALUES 

IF ARG 0 GE 1 THEN LOC i=ARG 1; ELSE LOC l=TTBO, 

IF ARG 0 GE 2 THEN LOC 2=ARG 2; ELSE LOC 2=0; 

IF ARG 0 GE 3 THEN LOC 3=ARG 3; ELSE LOC 3=19; 

IF ARG 0 GE 4 THEN LOC 4=ARG 4; ELSE LOC 4=1; 

IF LOC 4 LE 0 THEN 

LOC 8=L0C 1+<60*OLOC 4>>; ELSE 

LOC 8=L0C l+<60/LOC 4); ... INDEX ON RIGHT SIDE OF DISPLAY 

. . . PRINT HEADER 
NL 

TRACE BIT * AMPL LOGIC STATE ANALYZER * INDEX"; LOC 1:D; 
IF LOC 8 LE TTBN THEN LOC 8.D; ELSE TTBN : D; 


" EMU BIT"; NL; 

IF LOC 2 LT 4 THEN LOC 5=4-L0C 2; ELSE LOC 5-16- < LOC 2-4 >; 
LOC 6=1 

WHILE LOC 5 GT 1 DO BEGIN 

LOC 6=L0C 6*2; ... INITIALIZE MASK TO PROPER VALUE 


LOC 5=L0C 5-1; 


END; 


. SCAN A PAGE 


"TO"; 


WHILE LOC 2 LE LOC 3 DO BEGIN 

LOC 2 : D ... PRINT OUT BIT NUMBER 

/ . / . 
t 

LOC 5=L0C 1; 

LOC 7=1; 

. . . SCAN A LINE 


IF LOC 4 GT 0 THEN 
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WHILE LOC 5 LT LOC S DO BEGIN 

IF <LOC 5 GE TTBO> AND <LOC 5 LE TTBN> THEN 
IF LOC 2 LT 4 THEN LOC 9=TTBH<L0C 5>, ELSE 
LOC 9=TTB<L0C 5>, 

. . . PRINT OUT BIT STATE 

IF <LOC 6 AND LOC 9) EQ 0 THEN . . . HIGH OR LOW? 

' 'i ... LOW STATE 


. . . POSITIVE SCALE 
IF LOC 7 GE LOC 4 
LOC 5=L0C 5+1; 
LOC 7=8; 

END; 

LOC 7=L0C 7+1; 


. . . HIGH STATE 

FACTOR 
THEN BEGIN 

. . . INCREMENT WORD INDEX 
. . . RESET SCALE COUNTER 

. . . INCREMENT SCALE COUNTER 


END; 

ELSE . . . NEGATIVE SCALE FACTOR 

WHILE LOC 5 LT LOC 8 DO BEGIN 
LOC 7=-l; 

LOC 11=0; . - . RESET HIGH AND LOW FLAG 

WHILE LOC 7 GE LOC 4 DO BEGIN 
LOC 10=LOC 9 

IF CLOC 5 GE TTBO) AND <LOC 5 LE TTBN> THEN 
IF LOC 2 LT 4 THEN LOC 9=TTBH<L0C 5>; ELSE 
LOC 9=TTB<L0C 
ELSE LOC 11=2; 

LOC 9=L0C 9 AND LOC 6; 

IF LOC 7 EQ -1 THEN LOC 10=LOC 9 

IF LOC 10 NE LOC 9 THEN LOC 11=1 

LOC 7=L0C 7-1; . . . DECREMENT SCALE COUNT 

LOC 5=L0C 5+1; . . . INCREMENT INDEX 

END; 

. . . PRINT OUT BIT STATE 

IF LOC 11 EQ 1 THEN 'X'; ELSE ... NOT CONSTANT HIGH OR LOW 
IF LOC 11 EQ 2 THEN ' '; ELSE . . . OUT OF ARRAV BOUNDS 
IF LOC 9 EQ 0 THEN ... HIGH OR LOW? 

. . . LOW STATE 

ELSE 

. . . HIGH STATE 


END; 


. t 

IF LOC 2 GE 4 THEN 

LOC 2-4 :D; ... PRINT OUT BIT NUMBER WITH RESPECT TO EMULATOR 

ELSE IF LOC 2 EQ 01 THEN ' IRQ'; ... LABEL STATUS BITS 

ELSE IF LOC 2 EQ 02 THEN ' DBIN'; 

ELSE IF LOC 2 EQ 03 THEN ' EMU CMP'; 

IF LOC 2 NE LOC 3 THEN BEGIN 

LOC 6=L0C 6/2; . . . MASK FOR NEXT LINE 

NL; ... NEW LINE 

END; 

LOC 2=L0C 2+1; . . . INCREMENT LINE COUNT 

IF LOC 2 EQ 4 THEN LOC 6=>8000; . RESET BIT MASK 

END; 


END 
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. . TITLE: TRACE MODULE SAMPLE VERIFICATION 

..REVISION: 05/86/77 

ftBSTRRCT ' 

THESE TWO ROUTINES RECORD A TRACE MODULE TRACE BUFFER FULL OF 
SAMPLES ON A FILE AND THEN COMPARE THEM TO A SUBSEQUENT BUFFER FULL 
. . OF SAMPLES FOR CONSISTENCV. THE COMPARISON IS SUBJECT TO AN OPTIONAL 
. BIT MASK. 

. . USAGE : 

THE TRACE MODULE MUST BE HALTED AND CONTAIN SAMPLES IN ITS 
. BUFFER TO USE EITHER OF THESE PROCEDURES. TSAVE HAS ONE 
ARGUMENT, THE ACCESS NAME OF THE FILE ON WHICH THE CONTENTS OF THE 
TRACE BUFFER WILL BE SAVED. TVRFV HAS ONE REQUIRED ARGUMENT AND 
. . TWO OPTIONAL ARGUMENTS. THE FIRST ARGUMENT • MUST BE THE ACCESS NAME 
. . OF THE FILE CONTAINING THE TRACE SAMPLES SAVED BV TSAVE. THE SECOND 
. AND THIRD ARGUMENTS GIVE THE HIGH AND LOW-ORDER BIT MASKS. 

IF THE SECOND ARGUMENT IS OMITTED THE MASK >F IS USED. IF THE THIRD 
. ARGUMENT IS OMITTED, THE MASK >FFFF IS USED FOR THE LOW-ORDER PART 
. . COMPARISION. THE SAMPLES ARE COMPRED IN SEQUENCE. ANV DIFFERENCES 
. . ARE PRINTED. 

DEFINING TSAVE' NL 
PROC TSAVE <1, 1) BEGIN 

. TURN OFF THE CONSOLE SO THE LISTING TO THE FILE WILL GO FASTER. 
CNSLCOFF); 

OPEN THE FILE FOR LISTING AND WRITE THE TRACE BUFFER LIMITS. 

LIST< ARG 1) 

TTBO : DN; TTBN : DN; 

WRITE ALL THE SAMPLES FROM THE BUFFER, HIGH FOUR BITS FIRST, 

. . . FOLLOWED BV LOW SIXTEEN BITS OF EACH SAMPLE. 

FOR LOC 1 = TTBO TO TTBN DO BEGIN 

TTBHCLOC 1) : H1N; TTB<LOC 1>:HN; 

END; 

. . . TURN THE CONSOLE BACK ON AND THE LISTING FILE OFF. 

CNSLCON); 

LISTC'DUMV'); 

LISTCOFF); 

END 

'DEFINING TVRFV' NL 

PROC TVRFV Cl, 10) BEGIN 
CLSE; 

. . . OPEN THE FILE AND SET UP THE MASKS IN LOC 9 AND LOC 18. 

OPEN < ARG 1) 

IF ARG 0 GE 2 

THEN LOC 9 = ARG 2 
ELSE LOC 9 = ^F; 

IF ARG 0 GE 3 

THEN LOC 10 = ARG 3 
ELSE LOC 10 = >FFFF, 


Figure H-17. Listing of TRSAVR Procedure File (Sheet 1 of 2) 
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. ' . READ THE TRACE BUFFER LIMITS AND COMPARE TO THE CURRENT LIMITS. 

LOC 1 = READ; 

LOC 2 = READ; 

IF LOC 1 NE TTBO OR LOC 2 NE TTBN 
THEN BEGIN 

-FILE HAS - LOC 2-LOC 1+1 . 03 'SAMPLES, - 
LOC 1:03 . ' LOC 2 : D3 NL 

-TRACE BUFFER HAS ' TTBN-TTBO+1 : D3 -SAMPLES, - 

TTB0:D3 -. . . ' TTBN : D3 NL 

END; 

’ ’ LOOP THROUGH THE FILE AND THE TRACE BUFFER COMPARING SAMPLES. 

. . LOC 1 AND 3 MILL BE USED FOR INDICES. 

LOC 3 = TTBO; LOC 3 = 0; 

WHILE LOC 1 LE LOC 2 AND LOC 3 LE TTBN DO BEGIN 
LOC 4 = READ; LOC 5 = READ; 

LOC 6 = TTBHCLOC 3>; LOC 7 = TTBCLOC 3); 

IF CLOC 4 AND LOC 9> NE <LOC 6 AND LOC 9) 

OR <LOC 5 AND LOC 10 > NE <LOC 7 AND LOC 10 > 

THEN BEGIN 

IF LOC 8 EQ 0 

THEN BEGIN 

NL - FILE TRACE BUFFER '; 

- DIFFERENCE- NL, 

LOC 8 = 1; 

END; 

LOC 1 : D3; LOC 4: HI; LOC 5 : H; 

LOC 3 : D3, LOC 6. HI; LOC 7:HXX; 

< <LOC 4 AND NOT LOC 6> OR <NOT LOC 4 AND LOC 6>> 
AND LOC 9: HI; 

< (LOC 5 AND NOT LOC 7) OR <NGT LOC 5 AND LOC 7>> 
AND LOC 10 : HN; 

END; 

LOC 1 = LOC 1+1, LOC 3 = LOC 3+1, 

END; 

CLSE; 

END 


Figure H-17. Listing of TRSAVR Procedure File (Sheet 2 of 2) 
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APPENDIX I 
GLOSSARY 


This glossary contains definitions of terms used in the manual, some of which are defined in 

greater detail in other manuals. 

AMPL Microprocessor Prototyping Laboratory — A combination of hardware and software that 
executes in an FS990 or DS990 to develop prototype hardware and software. 

AMPL Microprocessor Prototyping Language — The language with which the user communicates 
with the AMPL system. When host memory consists of more than 16K words, an extended 
AMPL may be used, providing additional capabilities. 

Assembler - A computer program that develops a computer program by assembling machine 
instructions from source program statements. The computer program output by the assem- 
bler is called the object program. 

Breakpoint - The result of a computer reaching a predefined program condition or set of 
program conditions. Typically (but not necessarily) a breakpoint halts the computer. 

Buffer Module — The hardware module that interfaces between the emulator module and the 
target computer. A buffer module adapts the emulator module to emulate a specific 
microprocessor, i.e., a TMS 9900 buffer module is required to interface the emulator to a 
target computer that uses a TMS 9900 microprocessor. 

Data Probe — A connector that connects a single line to a point on a module or printed circuit 
board for test purposes. The trace module may be connected to desired points on the target 
system using a set of data probes. 

Delay Counter — A counter on the trace module that counts a specified number of traced items 
to delay the breakpoint signal. The delay counter begins to count when the event counter 
has counted the specified number of events. 

Emulator — A module that connects to a host computer at the CRU interface and to a target 
computer through the appropriate buffer module. The host computer controls the emulator 
as a peripheral device causing the emulator to control the target system for test purposes. 
The emulator includes memory that can be used as target system memory. 

Event — In the emulator, an event is a valid comparison between an address and a specified 
value. Alternatively, an external signal may be defined as an event. In the trace module, an 
event is a valid comparison between a value being stored in the trace memory and a 
specified value. The trace module may also use an external signal as an event. 

Event Counter — A counter in the trace module that counts events. The event counter in 
conjunction with the delay counter allows the user to specify a count of events and a delay 
count after which a breakpoint may occur. 
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Floppy Disc - A data storage device that stores data magnetically on the surface of a flexible 
disc (diskette). The floppy disc accesses data randomly. 

Format Specification - A set of one or more characters (table 4-2) preceded by a colon (:) used 
in a display statement to specify the format of the display. Format specification characters 
are effective in the order in which they are entered; they control conversions to decimal, 
hexadecimal, or octal values, or display in binary form or in ASCII character form. Other 
format specification characters insert spaces or carriage returns. 

Function - An AM PL subroutine that is called by entering the function name and arguments as 
a variable in an AMPL expression or statement, and which returns a value that is used as 
the value of the variable. 

Host Computer - The Model 990 Computer in which the AMPL Microprocessing Prototyping 
Laboratory software executes to control the microprocessor of a target system. 

Host Memory — The memory of the host computer. 

Host System - The AMPL Microprocessor Prototyping Laboratory system as it functions to 
control and test a target system. 

Link Utility - A computer program (TXLINK) that integrates object modules into a linked 
object module (load module). Typically each module requires addresses of labels defined in 
other modules (external references) and defines labels required in other modules (external 
definitions). Linking consists of satisfying the external references in a set of modules from 
the external definitions of these modules. 

Mask - A mask is used in a comparison between words or groups of bits to select the bits to be 
compared. The mask of a word comparison contains 16 bits and the mask of a comparison 
of a group of bits contains the number of bits in the group to be compared. Comparisons 
of qualifiers and stored values in the trace module are masked, allowing the user to select 
the bits for comparison. 

Procedure - An AMPL subroutine that is called by entering the procedure name and arguments 
as an AMPL statement. All transfer of data to or from the procedure is through arguments. 

Program Counter - An internal register in a computer or microprocessor of the 990 family 
which contains the address of the next instruction to be executed. 

Programmable Read-Only Memory - A memory device that may only be read which is 
programmed with the information (instructions and constants) it requires. 

PROM — Programmable Read-Only Memory. 

Qualifiers — A set of four lines connected to the trace module that selects the clocks at which 
values are stored. The user specifies bit values to which the qualifiers are compared and a 
mask that selects which qualifiers are compared. 

RAM - Random Access Memory. 
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Random Access Memory — A memory device that may be accessed for either reading or writing 
data. Addresses may be accessed randomly. 


Read-Only Memory - A memory device that may only be read. The information (instructions 
and constants) is stored in memory when it is manufactured. 

Status Register - An internal register in a computer or microprocessor of the 990 family that 
contains status bits set and reset to show the results of executing instructions, and the 
interrupt mask. 

Target Program - The program to be executed by the target system computer. 

Target System — The prototype system under test by the AMPL system. 

Target System Memory - The memory of the target system. The emulator can map either the 
program memory or the trace memory, or both, into target system memory. 

Terminal Executive Development System - A program development system that supports an 
assembler (TXMIRA), a Text Editor (TXEDIT), a Link Utility (TXLINK), and other 
utilities and executes in the FS990. 

Text Editor - A computer program (TXEDIT) that writes source files from user input, and 
allows the user to interactively edit the source files. 

TMS 9900 - A microprocessor of the 990 family, using a single chip, and N-channel silicon-gate 
MOS technology. A 16-bit processor using 16-bit memory access, with byte addressing. 

TMS 9980 - A microprocessor of the 990 family, using a single chip, and N-channel silicon-gate 
MOS technology. A 16-bit processor using 8-bit memory access, with byte addressing. 

Trace — In the emulator module, an operation that stores up to 256 addresses during emulation 
as specified by the user. In the trace module, an operation that stores up to 256 20-bit 
values as specified by the user. The 20 bits may be data from selected points on a 
prototype module, or may be either memory addresses or data from the emulator. The user 
may display the values stored in either the trace memory of the emulator or in the memory 
of the trace module. 

Trace Memory - A 256-word memory in the emulator which is used by the emulator to store 
traced addresses. Trace memory is also available to the target system. When the target 
system uses trace memory, addresses FE00 16 through FFFF, 6 ot target system memory 
space address the trace memory. 

Trace Module — A module that connects to a host computer at the CRU interlace and to the 
target computer or the emulator. The trace module may operate in conjunction with or 
independently of the emulator to store selected data and to compare stored data to 
specified criteria. The trace module may stop the trace when the specified number of values 
has been stored, or when a specified number of valid comparisons have been made, and a 
specified number of additional values has been stored. Alternatively, either of these con- 
ditions may cause the trace module to request the emulator to halt, or may interrupt the 
host computer. 
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ALPHABETICAL INDEX 
INTRODUCTION 


The following index lists key words and concepts from the subject material of the manual 
together with the area(s) in the manual that supply major coverage of the listed concept. The 
numbers along the right side of the listing reference the following manual areas: 

• Sections - References to Sections of the manual appear as “Section x” with the symbol 
x representing any numeric quantity. 

• Appendixes - References to Appendixes of the manual appear as “Appendix y” with the 
symbol v representing any capital letter. 

• Paragraphs - References to paragraphs of the manual appear as a series of alphanumeric 
or numeric characters punctuated with decimal points. Only the first character of the 
string may be a letter; all subsequent characters are numbers. The first character refers 
to the section or appendix of the manual in which the paragraph is found. 

• Tables - References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number: 

Tx-yy 

• Figures - References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number: 

Fx-yy 

• Other entries in the Index - References to other entries in the index are preceded by 
the word “See” followed by the referenced entry. 
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Address and Data Bus 

Checkout, Target System 3.2.2 

Address Mapping, Target Memory . . 4.5.5 .4, F4-1 

Addressing Example, Indirect 4. 5.5.4 

Altering Format Specifications 4. 6. 3. 3 

Alternate Qualifier Keywords T5-3 

AMPHDT Procedure 5.3, FH-1 

AMPL: 

Grammer Appendix C 

Language Introduction 3. 1.8.1 

Microprocessor Prototyping 

Laboratory F2-1 

Procedure and Function Library Appendix H 

Reserved Words Appendix E 

Statement Summary Appendix D 

Application, Prototyping Laboratory 3.3 

ARG Operator 4.7.3 

Arguments 4.7.3 

Arithmetic Operators 4.5.2 

Array: 

Reference 4.6.2 

Statement 4.6.1 

Arrays 4.2.4 

Assign Statement 4.6.2 

AT, Procedure FH-3 

Binary Constants 4. 2. 2.4 

BL, Procedure FH-9 

BLWP, Procedure FH-9 

Breakpoint: 

Comparison F3-1 

Emulator Trace F3-2 

Trace Module Trace F3-3 

Buffer Module F2-19 

Checkout 3.2.1 

Clock Switch 3.2.1, 3.2.3, 5.4 

Cable Connections 2.2.3 

Emulator F2-16 

Cables: 

Emulator/Buffer 2.2.3. 1 

Trace Module F2-4 

Cabling Diagram, Emulator/ Buffer .... F2-14 

Calls: 

Function 4.7.6 

Procedure 4.7.6 

CASE Statement 4.6.5 

CB, Procedure FH-IO 

CC, System Variable 4.6. 3.2, 4.7.7 

Character: 

Constants 4. 2. 2. 5 

Set 4.2.1 

Strings 4.2.5 

Characters, Format Specification T4-2 


Chassis Configuration: 

CRU Expansion F2-1 1 

DX10, Model 990/ 10 Computer F2-9, F2-10 
TX990, Model 990/4 Computer . F2-5, F-27 
TX990, Model 990/10 Computer . F2-6, F2-9 

Checking Program Results 7.9 

Checkout: 

Buffer Module 3.2.1 

Target System: 

Address and Data Bus 3.2.2 

Clock 3.2.3 

Memory 3.2.4 

Checks, Initial 3.2 

Circuit Board Installation 2.2.2 

Clear Test Environment Command .... 5.7.11 

Clock Checkout, Target System 3.2.3 

Clock Switch: 

Buffer Module 3.2.1, 3.2.3, 5.4 

Close Command 5.9.4 

CLR Command 3.1.2,5.7.11 

CLSE Command 5.9.4 

CMD Key 5.5 

CNSL Command 5.7.1 

Command Characters, Display and Modify T4-3 

Command: 

Close 5.9.4 

CLR 3.1.2,5.7.11 

CLSE 5.9.4 

CNSL 5.7.1 

COPY 3.1.2,3.2.1,5.7.14 

CRU Read 5.8.1 

CRU Write 5.8.2 

CRUR 5.8.1 

CRUW 5.8.2 

Define Console 5.7.1 

Define Listing Device 5.7.2 

Define Trace Breakpoint 5.11.2 

Delay AMPL Execution 5.7.16 

DELE 5.7.15 

Delete 5.7.15 

Delete Load Module Symbol 

Table 5.7.8 

Display Load Module Symbol 

Table 5.7.7 

Display Register 5.7.5 

Display System Symbol Table 5.7.9 

Display User Symbol Table 5.7.6 

D1V 5.7.4 

Divide 5.7.4 

DR 5.7.5, 7.5 

DUMP 5.6.2 

EBRK 3.1.1,3.3,5.10.2,7.5, 

7.7, 7.10 

ECMP 3.1.1,3.3,5.10.4,7.5, 

7.7, 7.9, 7.10 
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EDIT 5.7.13 

EEVT 3.1.1,3.3,5.10.3,7.5,7.10 

EHLT 3.1.1, 3.2.1, 3.2.2, 3.2.3, 


TTB 5.11.8 

TTBH 5.11.9 


3.2.4, 5.10.7 


E1NT 3.1.1, 3.2.1, 3.2.3, 5.10.1, 7.3 

Enter Text Editor 5.7.13 

EOF 5.9.3 

ERUN 3.1.1, 3.2.1, 3.2.2, 3.2.3, 3.2.4 

3.3, 3.4, 5.10.6, 7.5, 7.6. 7.9, 7.10 

ETB 4.7.7,5.10.8 

ETRC 3.1.1,3.3,5.10.5,7.5,7.7,7.10 

EXIT 5.7.19 

HCRR 5.8.3 

HCRW 5.8.4 

Host CRU Read 5.8.3 

Host CRU Write 5.8.4 

Initialize Compare Logic 5.10.4 

Initialize Emulator 5.10.1 

Initialize Trace Compare Logic 5.11.4 

Initialize Trace Logic 5.10.5 

Initialize Trace Module 5.11.1 

Initialize Trace Module Trace 

Logic 5.11.5 

LIST 3.1.2, 5.7.2 

LOAD 5.6.1, 7.3 

MDEL 5.7.8 

MPY 5.7.3 

MSYM 5.7.7 

Multiply 5.7.3 

New Line 5.7.17 

NL 5.7.17 

OPEN 5.9.1 

READ 5.9.2 

Read High Order Trace 

Module Memory 5.11.9 

Read Low Order Trace 

Module Memory 5.11.8 

Read Trace Memory 5.10.8 

Restore Test Environment 5.7.12 

RSTR 5.7.12 

SAVE 5.7.10 

Save Test Environment 5.7.10 

Select Event 5.10.3 

Select Trace Event 5.11.3 

SSYM 5.7.9 

Start Microprocessor 5.10.6 

Start Trace 5.11.6 

Stop Microprocessor 5.10.7 

Stop Trace 5. 1 1 .7 

TBRK 3.1.2,3.3,3.4,5.11.2,7.10 

TCMP 3.3,3.4,5.11.4 

Terminate AMPL Program 5.7.19 

TEVT 3.3,3.4,5.11.3 

THLT 5.11.7 

TINT 3.1.2, 5.11.1, 7.10 

TRUN 3.3.3.4,5.11.6,7.10 


TTRC 3.1.2,3.3,3.4,5.11.5,7.10 

USYM 5.7.6 

Verify 5.7.18 

VRFY 5.7.18 

WAIT 5.7.16 

Commands: 

CRU 5.8 

Data Input 5.9 

Emulator Control 3.1.1 

Emulator Operation 5.10 

Entering 5.5 

Program 5.6 

Trace Module 3.1.2 

Trace Module Operation 5.11 

User Appendix G 

Utility 5.7 

Comments 4.2.6 

Comparison Breakpoint F3-1 

Components, System 2.1.2, T2-1 

Compound Statement 4.6.9, 7.4 

Computer Chassis 
Configuration: 

DX 10, Model 990/10 F2-9 

TX990, Model 990/4 F2-5, F2-3 

TX990, Model 990/10 F2-6, F2-9 

Installation 2.2.1 

Configuration: 

CRU Expansion Chassis F2-11 

DX 10, Model 990/ 10 Computer F2-9, F2-10 

Software 1.4 

System 2.1.1, FI-2, F2-2 

TX990: 

Model 990/4 Computer F2-5, F2-7 

Model 990/ 10 Computer F2-6, F2-9 

Connection Modification, Interrupt .... 2.2. 1.2 
Connections: 

Cable 2.2.3 

Emulator Cable F2-16 

Target System 2. 2. 3. 2, F2-22 

TMS 9900 Target System F2-17 

TMS 9980 Target System F2-I8 

Trace Module 2. 2. 3. 3, F2-20 

Constants 4.2.2 

Binary 4. 2. 2. 4 

Character 4. 2. 2. 5 

Decimal 4.2.2. 1 

Hexadecimal 4. 2. 2. 2 

Instruction 4. 2. 2. 6 

Octal 4.2. 2.3 

Contents: 

TMS 9980, Trace Memory F5-3 

Trace Memory F5-2 

Copy Command 3.1.2,3.2.1,5.7.14 

CRU Commands 5.8 
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CRU Expansion Chassis Configuration . F2-II 

CRU Read Command 5.8.1 

CRU Write Command 5.8.2 

CRUB, System Variable 5.8.1 

CRUR Command 5.8.1 

CRU W Command 5.8.2 

Cycle, Prototype Development 1.2, FI- 1 

Data Input Commands 5.9 

Data Probe Terminator and Leads .... F2-21 

DAY, System Variable 5.5 

DEBUG Procedure Documentation .... FH-4 

Debugging, Initial 7.4 

Decimal Constants 4.2.2. 1 

Define Breakpoint Conditions Command 5.10.2 

Define Console Command 5.7.1 

Define Listing Device Command 5.7.2 

Define Trace Breakpoint Command . . . 5.11.2 

Delay AMPL Execution Command . . . 5.7.16 

DELAY Procedure FH-3 

DELE Command 5.7.15 

Delete Command 5.7.15 

Delete Load Module Symbol 

Table Command 5.7.8 

Demonstration Test, Hardware 5.3 

Development Cycle, Prototype 1.2, FI -I 

Diagram, Emulator/ Buffer Cabling .... F2-14 

Display and Modify 4. 6. 3. 5, 7.9 

Command Characters T4-3 

Display, Instruction 4. 6. 3. 2 

Display Load Module Symbol 

Table Command 5.7.7 

Display Register Command 5.7.5 

Display Statement 4.6.3 

Display System Symbol Table 

Command 5.7.9 

Display User Symbol Table 

Command 5.7.6 

Displaying: 

Target Memory 4. 6.3.4 

Traced Addresses 7.8 

DIV Command 5.7.4 

Divide Command 5.7.4 

Documentation, Procedure DEBUG .... FH-4 

Documents, Related Preface 

DR Command 5.7.5, 7.5 

DST, System Variable 4. 6. 3. 2 

DT Procedure FH-3 

DUMP Command 5.6.2 

DX10 LI 

Model 990/10 Computer Chassis 

Configuration F2-9, F2-10 

Prototyping Laboratory Peripherals . . F2-25 

System Generation Appendix B 


System: 

Loading 5.2.2 

Starting 5.2.2 

EB, Procedure FH-10 

EBRK Command 3.1.1,3.3,5.10.2,7.5, 

7.7, 7.10 

ECMP Command 3.1.1,3.3,5.10.4,7.5, 

7.7, 7.9, 7.10 

EDIT Command 5.7.13 

EDUMP Procedure FH-5 

EEVT Command . . 3.1.1, 3.3, 5.10.3, 7.5, 7.10 

EHTL Command .... 3.1.1, 3.2.1, 3.2.2, 3.2.3, 

3.2.4, 5.10.7 

EINT Command . 3.1.1, 3.2.1, 3.2.3, 5.10.1, 7.3 


Elements, Language 4.2 

EMT, System Variable 5.10 

Emulator Cable Connections F2-16 

Emulator Control: 

Commands 3.1.1 

Variables 3.1.1 

Emulator: 

Module F'2-15 

Operation 7.5 

Emulator Operation Commands 5.10 

Emulator Status T5-1 

Emulator Trace Breakpoint F3-2 

Emulator Tracing 7.6 

Emulator-Trace Module 

Interconnections 2. 2. 3.4, F2-23 

Emulator/ Buffer: 

Cables 2.2.3. 1 

Cabling Diagram F2-14 

Interconnection F2-3 

ENI, System Variable 5.10.2.1 

Enter Text Editor Command 5.7.13 

Entering Commands 5.5 

EOF Command 5.9.3 

Error message T6-1 

Formats 6.2 

Introduction 6.1 

ERUN Command .... 3.1.1, 3.2.1, 3.2.2, 3.2.3, 

3.2.4, 3.3, 3.4, 5.10.6, 7.5, 7.6, 7.9, 7.10 

ESCAPE Statement 4.6.10 

EST System Variable 3.1.1,5.10.6.1 

ESTAT Procedure .... 3.1.1, 3.2.1, 3.2.2, 3.2.3, 

3.2.4, 3.3, FH-13 

ETB Command 4.7.7, 5.10.8 


ETBN System Variable . . . 3.1.1, 4.7.7, 5.10.8.2 
ETBO System Variable . . . 3.1.1, 4.7.7, 5.10.8.1 
ETM System Variable .... 3.1.1, 4. 5. 5. 4, 5.10, 

7.3, 7.5 

ETRC Command 3.1.1, 3.3, 5.10.5, 7.5, 7.7, 7.10 

EUM System Variable 3.1.1, 3.2.1, 3.2.4, 

4.5.5.4,5.10,7.3 
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Evaluation, Expression 4.5.6 

Event Modes T5-2 

Example: 

Function 4.7.7 

Indirect Addressing 4. 5. 5. 4 

Introduction 7.1 

Procedure 4.7.7 

Program 7.2 

Listing F7-1 

Loading 7.3 

Target System Front End F3-8 

TDATA Printout F3-5 

TEDUMP Printout F3-7 

Trace probe 3.4, F3-9 

Examples, TMS 9980 3.5 

Execution: 

FOR Statement F4-5 

IF Statement F4-2 

REPEAT Statement F4-4 

WHILE Statement F4-3 

EXIT Command 5.7.19 

Expression Evaluation 4.5.6 

Expressions 4.5 

Features, Operational 1.3 

FIFO Counter Operation F3-6 

FNDBYT Function FH-6 

FNDWRD Function FH-7 

FOR Statement 4.6.8 

FOR Statement Execution F4-5 

Format 4.4 

Format Character: 

Cl 4.6.3. 3 

I 4. 6. 3. 2 

Format Specification 4.6.3. 1 

Characters T4-2 

Format Specifications, Altering 4. 6. 3. 3 

Formats, Error Message 6.2 

Formula, Instruction Timing 4.6. 3.2 

Front End. Example Target System .... F3-8 

FUNC Statement 4.7.2 

Function Calls 4.7.6 

Function Definition Statement 4.7.2 

Function: 

Example 4.7.7 

FNDBYT FH-6 

FNDWRD FH-7 

GETCHR FH-2 

INTR FH-9 

Library 4.7, Appendix H, TH-1 

G Format Character 4.6. 3. 3 

GETCHR Function FH-2 

Glossary Appendix 1 

Grammer, AM PL Appendix C 


HALT Procedure FH-3 

Hardware: 

Demonstration Test 5.3 

Installation, System 5.8.3 

HCRB, System Variable 5.8.3 

HCRR Command 5.8.3 

HCRW Command 5.8.4 

HELP: 

Key 5.5 

Procedure FH-3 

Hexadecimal Constants 4. 2. 2. 2 

Hierarchy of Operations 74-1 

HIST, Procedure FH-8 

Host CRU Read Command 5.8.3 

Host CRU Write Command 5.8.4 

HR, System Variable 5.5 


I Format Character 

IF Statement 

Execution 

Indirect: 

Addressing Example 

Operator 

Initial: 

Checks 

Debugging 

Initialize Compare Logic Command 
Initialize Emulator Command . . . 
Initialize Trace Compare 

Logic Command 

Initialize Trace Logic Command . . 
Initialize Trace Module Command 
Initialize Trace Module 

Trace Logic Command 

INITRM Procedure 

Installation: 

Circuit Board 

Computer 

System Hardware 

INSTR Procedure 

Instruction: 

Constants 

Display 

Timing Formula 

Interconnection, Emulator/ Buffer . 
Interconnections, Emulator-Trace 

Module 

Interrupt: 

Connection Modification 

Jumper Plug Location 

Jumper Plugs 

Levels 

INTR Function 

Introduction 

AM PL Language 


. . . . 4. 6. 3. 2 

4.6.4 

F4-2 

. . . . 4.5. 5. 4 
. . . . 4.5. 5.4 

3.2 

7.4 

. . . 5.10.4 
. . . . 5.10.1 

. . . . 5.11.4 
. . . . 5.10.5 
. . . . 5.11.1 

. . . . 5.11.5 
FH-2 

2.2.2 

2.2.1 

2.1 

FH-3 


.... 4. 2.2.6 
.... 4.6.3. 2 
.... 4.6.3. 2 
F2-3 

2. 2. 3.4, F2-23 

. . . . 2 . 2 . 1. 2 
.... F2-12 
. . . . F2-13 
. . . . 2 . 2 . 1. 1 
FH-9 


3.1, 4.1 
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Error Message 6.1 

Example 7.1 

System Operation 5.1 

Jumper Plug Location, Interrupt F2-12 

Jumper Plugs, Interrupt F2-13 

Key: 

CMD 5.5 

HELP 5.5 

Keywords, Alternate Qualifier T5-3 

Language Elements 4.2 

Leads, Data Probe Terminator and .... F2-21 

Levels, Interrupt 2. 2. 1.1 

Library, AMPL Procedure and 

Function Appendix H, F3-4, TH-1 

LIST Command 3.1.2, 5.7.2 

Listing, Example Program F7-1 

LOAD Command 5.6.1, 7.3 

Load Module Symbols 4. 2. 3. 3, 5.6.1 

Loading: 

DX 10 System 5.2.2 

Example Program 7.3 

TX990 System 5.2.1 

LOADUP Procedure FH-3 

LOC Operator 4.7.4 

Local Storage 4.7.4 

Location, Interrupt Jumper Plug F2-12 

Logical Operators 4.5.3 

Mapping, Target Memory 

Address 4. 5.5.4, F4-1 

MC, System Variable 4. 6. 3. 2, 4.7.7 

MDEL Command 5.7.8 

MDR, System Variable .... 4.5.6, 5.7.3, 5.7.4 

Memory Checkout, Target System 3.2.4 

Messages: 

Error T6-1 

Warning T6-1 

Microprocessor Command, Stop 5.10.7 

MIN, System Variable 5.5 

Model 990/4 Computer Chassis 

Configuration TX990 F2-5, F2-7 

Model 990/ 10 Computer Chassis 
Configuration: 

DX10 F2-9, F2-10 

TX990 F2-6, F2-9 

Modes, Event T5-2 

Modification, Interrupt Connection .... 2.2. 1.2 

Module, Emulator F2-15 

Monitoring Program Execution 7.7 

MPY Command 5.7.3 

MREAD Procedure FH-3 

MSYM Command 5.7.7 


Multiply Command 5.7.3 

M WRITE Procedure FH-3 

Negation 4.5. 5.2 

New Line Command 5.7.17 

NL Command 5.7.17 

Notation 4.3 

NULL Statement 4.6.11 


Octal Constants 4.2.2.3 

One’s Complement 4. 5. 5. 3 

OPEN Command 5.9.1 

Operation: 

Emulator 7.5 

FIFO Counter F3-6 

Introduction, System 5.1 

Trace Module 7.10 

Operational Features 1.3 

Operations, Hierarchy of T4-1 

Operator: 

ARG 4.7.3 

Indirect 4.5. 5.4 

LOC 4.7.4 

Operators: 

Arithmetic 4.5.2 

Logical 4.5.3 

Relational 4.5.4 

Unary 4.5.5 


Peripherals: 

DX10, Prototyping Laboratory . . 2.3, F2-25 


TX990, Prototyping Laboratory . 2.3, F2-25 

Plus, Unary 4.5.5. 1 

Power, Restoring 5.4 

Printout, Example: 

TDATA F3-5 

TEDUMP F3-7 

PROC Statement 4 7.1,7.9 

Procedure: 


AMPHDT 5.3, FH-I 

Library, AMPL Appendix H 

AT FH-3 

BL FH-9 

BLWP FH-9 

Calls 4.7.6 

CB FH-10 

DEBUG Documentation FH-4 

Definition Statement 4.7.1 

DELAY FH-3 

DT FH-3 

EB FH-10 

EDUMP FH-5 

ESTAT 3.1.1, 3.2.1, 3.2.2, 3.2.3, 3.2.4, 

3.3, FH-13 

Example 4.7.7 
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HALT .... 
HELP .... 

HIST 

1NITRM . . 
1NSTR 
Library . . . 
LOADUP . . 
MREAD . . 
MWRITF. . . 
PUTCHR . . 
Recovery . . 

RT 

RTWP 

RUN 

SB 

SETMEM . 

SIE 

STAT 

TDATA . . . 
TDUMP . . 
TEDUMP . 
TFOUR . . . 

TILL 

TIMER . . . 
TRACE . . 
TSAVE . . 
TSTAT . . 
TVRFY . . 
VALUE . . 
XOP .... 
Procedures and 
Procedures and 


FH-3 

FH-3 

FH-8 

FH-2 

FH-3 

F3-4 

FH-3 

FH-3 

FH-3 

FH-2 

5.4 

FH-9 

FH-9 

FH-3 

FH-10 

FH-11 

FH-12 

FH-3 

3.1.2, 3.3, FH-14 

FH-5 

3.3, FH-5 

FH-14 

FH-3 

FH-15 

. . FH-3, FH-16 

FH-17 

3.1.2, 3.3, FH-13 

FH-17 

FH-3 

FH-9 


Functions 4.7 

Functions, Library TH-1 


Program: 

Commands 

Example 

Execution, Monitoring 

Listing, Example 

Results, Checking 


Prototype Development Cycle 1.2, F 1-1 

Prototyping Laboratory: 

Application 3.3 

Peripherals 2.3 

DX 10 F2 ' 25 

TX990 F2 - 24 

PUTCHR Procedure FH-2 


Qualifier: 

Keywords, Alternate 

Q0 

Q0, Qualifier 


T5-3 

3.5 

3.5 


READ Command 5.9.2 

CRU 5 - 81 

Read High Order Trace Module 

Memory Command 5.11.9 


Read Low Order Trace Module 

Memory Command 5.11.8 

Read Trace Memory Command 5.10.8 

Recovery Procedure 5.4 

Reference, Array 4.6.2 

Related Documents Preface 

Relational Operators 4.5.4 

REPEAT Statement 4.6.7, 7.7, 7.8 

Repeat Statement Execution F4-4 

Reserved Words, AMPL Appendix E 

Restore Test Environment Command . . 5.7.12 

Restoring Power 5.4 

Results, Checking Program 7.9 

RETURN Statement 4.7.5 

RSTR Command 5.7.12 

RT Procedure FH-9 

RTWP Procedure FH-9 

RUN Procedure FH-3 


SAVE Command 

Save Test Environment Command 

SB Procedure 

SEC, System Variable 

Select Event Command 

Select Trace Event Command . . 

Set, Character 

SETMEM, Procedure 

SIE Procedure 

Size, Symbol Table 

Software Configuration 

SRC, System Variable 

SSYM Command 

Start Microprocessor Command . 

Start Trace Command 

Starting: 

DX10 

TX 990 

STAT Procedure 

Statement: 

Array 

Assign 

Compound 

Display 

ESCAPE 

FOR 

FUNC 

Function Definition 

IF 

NULL 

PROC 

Procedure Definition 

REPEAT 

RETURN 

Summary, AMPL 

WHILE 


5.7.10 

.... 5.7.10 
.... FH-10 

5.5 

.... 5.10.3 
.... 5.11.3 

4.2.1 

.... FH-11 
.... FH-12 

5.7.11 

1.4 

.... 4. 6. 3. 2 

5.7.9 

.... 5.10.6 
.... 5.11.6 

5.2.2 

5.2.1 

FH-3 

4.6.1 

4.6.2 

. . 4.6.9, 7.4 

4.6.3 

.... 4.6.10 

4.6.8 

4.7.2 

4.7.2 

4.6.4 

.... 4.6.1 1 
. . 4.7.1, 7.9 

4.7.1 

4.6.7, 7.7, 7.8 

4.7.5 

Appendix D 
4.6.6, 7.6, 7.10 
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Statements 4.6 

Status: 

Emulator T5-1 

Trace Module T5-4 

Stop Microprocessor Command 5.10.7 

Stop Trace Command 5.11.7 

Storage, Local 4.7.4 

Strings, Character 4.2.5 

Subexpressions 4.5.1 

Summary, AMPL Statement .... Appendix D 

Symbol Table Size 5.7.11 

Symbols 4,2.3 

Load Module 4.2.3. 3, 5.6.1 

System 4.2. 3.2, Appendix F 

User 4.2.3. 1 

System: 

Components 2.1.2, T2-1 

Configuration 2. LI, FI -2, F2-2 

Connections: 

Target 2.2.3.2, F2-22 

TMS 9900 F2-17 

TMS 9980 F2-18 

System Generation: 

DX10 Appendix B 

TX990 Appendix A 

System: 

Hardware Installation 2.1 

Loading 5.2 

DX10 5.2.2 

TX990 5.2.1 

Operation Introduction 5.1 

Starting 5.2 

DX10 5.2.2 

TX990 5.2.1 

Symbols 4.2. 3.2, Appendix F 

System Variable: 

CC 4. 6. 3. 2, 4.7.7 

CRUB 5.8.1 

DAY 5.5 

DST 4. 6. 3. 2 

F.MT 5.10 

ENI 5.10.2.1 

EST 3.1.1,5.10.6.1 

FT BN 3.1.1,4.7.7,5.10.8.2 

ETBO 3.1.1.4.7.7,5.10.8.1 

ETM 3.1.1,4.5.5.4,5.10,7.3,7.5 

EUM 3.1.1, 3.2.1, 3.2.4, 4.5.5.4, 

5.10, 7.3 

HRCB 5.8.3 

HR 5.5 

MC 4. 6. 3. 2, 4.7.7 

MDR 4.5.6, 5.7.3, 5.7.4 

MIN 5.5 

SEC 5.5 

SRC 4.6. 3. 2 


TIME 4.6. 3.2, 4.7.7 

TNE 5.11.2.1 

TNI 5.11.2.2 

TST 3.1.2,5.11.6.1 

TTBN 3.1.2,5.11.8.2 

TTBO 3.1.2,5.11.8.1 

YR 5.5 

Target Memory: 

Address Mapping 4. 5. 5.4, F4-1 

Displaying 4. 6. 3. 4 

Target System: 

Address and Data Bus Checkout 3.2.2 

Clock Checkout 3.2.3 

Connections 2. 2. 3. 2, F2-22 

Connections TMS 9900 F2-17 

Connections TMS 9980 F2-18 

Front End, Example F3-8 

Memory Checkout 3.2.4 

TBRK Command .. 3.1.2,3.3,3.4,5.11.2,7.10 

TCMP Command 3.3, 3.4, 5.11.4 

TDATA: 

Printout Example F3-5 

Procedure 3.1.2, 3.3, FH-14 

TDUMP Procedure FH-5 

TEDUMP: 

Printout Example F3-7 

Procedure 3.3, FH-5 

Terminal Executive 1.1 

Terminal Executive Development 

System 1.1 

Terminate AMPL Program Command . 5.7.19 
Terminator and Leads. Data Probe .... F2-21 

Test, Hardware Demonstration 5.3 

TEVT Command 3.3, 3.4, 5.11.3 

TFOUR Procedure FH-14 

THLT Command 5.11.7 

TILL Procedure FH-3 

TIME, System Variable 4. 6. 3. 2, 4.7.7 

TIMER Procedure FH-15 

Timing Formula, Instruction 4. 6. 3. 2 

TINT Command 3.1.2,5.11.1,7.10 

TMS 9900, Target System 

Connections F2-17 

TMS 9980: 

Examples 3.5 

Target System Connections F2-18 

Trace Memory Contents F5-3 

TNE, System Variable 5.11.2.1 

TNI, System Variable 5.11.2.2 

Trace Breakpoint, Trace Module F3-3 

Trace Memory Contents F5-2 

TMS 9980 F5-3 

Trace Module F2-4 

Cables F2-4 
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Commands 3.1.2 

Connections 2. 2. 3.. 3, F2-20, F5-1 


Operation 7.10 


Operation Commands . . . 
Status 

5.11 

T5-4 

Trace Breakpoint 

F3-3 

Variables 

3.1.2 

Trace Module-Emulator 

Interconnections 

. . . 2. 2.3. 4, F2-23 

Trace Probe Example 

3.4, F3-9 

TRACE Procedure 

. . . FH-3, FH-16 

Traced Addresses. Displaying 

7.8 

Tracing. Emulator 

7.6 

TRUN Command 

3.3. 3.4, 5.1 1.6, 7.10 

TSAVE Procedure 

FH-I7 

1ST System Variable 

. . . 3.1.2, 5.11.6.1 

TSTAT Procedure 

. 3.1.2, 3.3, FH-13 

TTB Command 

5.11.8 

TTBH Command 

5.11.9 

TTBN, System Variable . . , 

. . . 3.1.2, 5.1 1.8.2 

TTBO, System Variable . . . 

. . . 3.1.2, 5.11.8.1 

TTRC Command . . 3.1.2, 

3.3, 3.4. 5.11.5, 7.10 

TVRFY Procedure 

FH-17 

TXDS 

1.1 

TX9Q0 

1.1 

Model 990/4 Computer Chassis 

Configuration 

F2-5, F2-7 

Model 990/ 10 Computer Chassis 

Configuration 

F2-6, F2-9 

Prototyping Laboratory 

Peripherals 

F2-24 


System Generation Appendix A 

System: 

Loading 5.2.1 

Starting 5.2.1 

Unary: 

Operators 4.5.5 

Plus 4.5.5. 1 

User: 

Commands Appendix G 

Symbols 4.2.3. 1 

USYM Command 5.7.6 

Utility Commands 5.7 

VALUE Procedure FFF-3 

Variables: 

Emulator Control 3.1.1 

Trace Module 3.1.2 

Verify Command 5.7.18 

VRFY Command 5.7.18 

WALL Command 5.7.16 

Warning Messages 16-1 

WHILE Statement 4.6.6, 7.6, 7.10 

Execution F4-3 

Words, AMPL Reserved Appendix E 

XOP Procedure F'H-9 

YR, System Variable 5.5 
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